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Preface 


This manual contains information about the following: 

e The VMS Version 5.2 installation procedure 

¢ The VMS Version 5.2 upgrade procedure 

¢ Installing VMS DECwindows software 

If you are going to install the VMS operating system, follow the 
installation procedure in this guide. Refer to the VMS installation and 
operations guide for your VAX computer for information specific to your 


computer, such as turning on the system, booting standalone BACKUP, 
and booting the new system disk. 


If you are going to upgrade to Version 5.2 of the VMS operating system, 
follow the upgrade procedure in this guide. 


Intended Audience 


This manual is intended for system managers, operators, and users of the 
VMS operating system. Read this manual before you install, upgrade, or 
use Version 5.2 of the VMS operating system. 


Document Structure 
This manual contains the following chapters: 


¢ Chapter 1 describes what happens during an installation or an 
upgrade. 


¢ Chapter 2 describes how to install Version 5.2 of the VMS operating 
system. 


¢ Chapter 3 lists the tasks you should perform after you install the VMS 
operating system. 


e Chapter 4 contains cautions, restrictions, notes, and suggestions about 
upgrading your VAX computer system. 


¢ Chapter 5 tells you how to prepare your system for an upgrade. 


e Chapter 6 describes the procedures for upgrading a VAXcluster 
environment. 


¢ Chapter 7 describes the procedures for upgrading a single computer 
system. 


¢ Chapter 8 lists the tasks you should perform after the upgrade. 


¢ Chapter 9 describes the VMS User Environment Test Package (UETP) 
and how to use it to test the system. 


¢ Appendix A describes how to boot from SYSF on the different types of 
VAX computers. 
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e Appendix B contains supplemental information about starting and 
customizing VMS DECwindows software. 


e Appendix C lists the files in the VMS library and optional save sets. 
e Appendix D lists the files in VMS DECwindows software. 


e Appendix E outlines layered product support for Version 5.2 of the 


VMS operating system. 


e Appendix F describes release notes for the VAX 8200 computer. 





Conventions 


Xiv 


The following conventions are used in this manual: 


Ctrl/x 


red ink 


boldface text 


UPPERCASE TEXT 


numbers 


A sequence such as Ctrl/x indicates that you must 
hold down the key labeled Cirl while you press 
another key or a pointing device button. 


A vertical ellipsis indicates the omission of items from 
a code example or command format; the items are 
omitted because they are not important to the topic 
being discussed. 


Red ink indicates information that you must enter from 
the keyboard or a screen object that you must choose 
or click on. For online versions, user input is shown in 
bold. 


Boldface text represents the introduction of a new 
term or the name of an argument, an attribute, or a 
reason. 


Uppercase letiers indicate the name of a routine, the 
name of a file, the name of a file protection code, or 
the abbreviation for a system privilege. 


Unless otherwise noted, all numbers in the text are 
assumed to be decimal. Nondecimal radixes—binary, 
ociai, of hEexadecimai—are expiicitiy indicated. 


This manual often refers to products by their abbreviated names. For 
example, the VAX 8200, VAX 8250, VAX 8300, and VAX 8350 computers 
are referred to collectively as the VAX 8200, 8250, 8300, 8350. The 
MicroVAX 2000 computer is referred to as the MicroVAX 2000, and so 


on. 





Part | 


Part | contains information about installing Version 5.2 of the VMS operating 
system. 


4 The Installation and Upgrade Procedures 


CAUTION: 


This chapter describes what happens during the installation and upgrade 
procedures. It also tells whether you should do an installation or an 
upgrade, and refers you to the appropriate documentation. 


Please note the following restrictions for Version 5.2 of the VMS 
operating system: 


e The MicroVAX I, VAXstation I, and VAX-11/725 are not 
supported. 


¢ RKO, RLO2, RC25, RD51, and RD52 system disks are not 
supported. 


1.1 What Happens During an Installation 


CAUTION: 


When you install the VMS operating system, the installation procedure 
does the following: 


e Initializes the system disk, erasing its contents 
¢ Creates a system directory structure 


e Transfers the VMS files from the distribution media to the system disk 


Use the installation procedure under the following conditions: 


e If your VAX computer is new (it has never had any version of the 
operating system running on it). 


¢ If your VAX computer is running a version of the VMS operating 
system and you want to destroy the entire contents of the system disk 
(both VMS and user files). 


e If you are running the VMS operating system, but cannot upgrade. 
For example, if you changed the names of system directories on the 
system disk, the upgrade procedure will not work correctly. You can 
either restore the system disk to its original disk structure, or you 
could re-install the VMS operating system. 


The installation procedure initializes the system disk, erasing its 
contents. For this reason, use the installation procedure only on 
new VAX computers or if you want to destroy the contents of the 
system disk. 


If you are installing the VMS operating system, see Chapter 2. 
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1.2 What Happens During an Upgrade 


CAUTION: 


When you upgrade the VMS operating system, the upgrade procedure does 
the following: 


e Makes room for the upgrade by purging and deleting select VMS files 
but leaves all the user files intact 


© Transfers the VMS files from the distribution media to the system disk 


¢ Merges the old VMS files and the new VMS files 


e Cleans up files and structures used only during the upgrade 


In most cases, if you are already running a standard version of the VMS 
operating system, you can use the upgrade procedure to obtain a higher 


version. The upgrade procedure does not intitialize the system disk. 


The upgrade procedure will not work correctly if you have 
changed the names of system directories on your system disk. 
Restore your VMS system disk to a standard system before 
attempting an upgrade. 


If you are upgrading your system, go to Chapter 4. 


2 Installing the VMS Operating System and DECwindows 
Software 


This chapter describes installing Version 5.2 of the VMS operating system 
and DECwindows software. You can use this procedure to install the VMS 
operating system on any VAX computer. Use this chapter in conjunction 
with the VMS installation and operations guide for your VAX computer. 
The VMS installation and operations guide has information specific to your 
computer, such as turning on the system, booting standalone BACKUP, 
and booting the new system disk. 


CAUTION: The software installation procedure overwrites the contents of 
the system disk. Use the installation procedure only if your VAX 
computer is new, or if you want to destroy the contents of the 
system disk. If your system disk contains files that you want 
to save, you should upgrade to the new version of VMS. For a 
complete description of the upgrade procedure, see Chapter 4. 





2.1 Before You Start 
Before you install the VMS operating system, do the following: 


e Make sure the hardware has been installed and checked for proper 
operation. For detailed information on the hardware, see the hardware 
manual for your VAX computer. 


e Make sure you have all the items listed on the bill of materials in the 
VMS distribution kit. If your kit is incomplete, notify Digital Software 
Supply. Request priority shipment of any missing items. 


e Read “Before Installing VMS” in the VMS installation and operations 
guide for your VAX computer. It contains important information, 
specific to your VAX computer, that you need to know before you do an 
installation. 


e Ifyou are installing the VMS operating system on a VAX computer in a 
VAXcluster environment, determine whether you want a Cl-only, local 
area, or mixed-interconnect configuration. For a complete description 
of configurations, see the VMS VAXcluster Manual. Depending on the 
type of configuration, you need to obtain the following information 
from either the network or VAXcluster manager: 


— C]-Only Configuration: Obtain the allocation class value, the 
DECnet node name, and node address for the computer. 


— Local Area and Mixed-Interconnect Configurations: You need the 
allocation class value, the DECnet node name, and node address 
for the computer. You also need the cluster group number and 
password. 
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Installing the VMS Operating System and DECwindows Software 
2.1 Before You Start 


e Ifyou have a VAX computer that uses console media, you also need the 
most recent version of the console media. For example, if you have a 
VAX-—11/780, you need the most recent version of the console RX01. 


During the installation procedure, the VMS files are transferred from the 
distribution kit to the system disk. You also have the option of installing 
VMS DECwindows software. The following is a list of the tasks involved: 


Turning on the system 

Preparing the disk and tape drives 

| Booting standalone BACKUP 
Creating the system disk 

ss VMS DECwindows software 


taw 
ng a vd Xl UCL 


Oo o Fh OW NO = 


“i 


Specifying passwords, installing the mandatory i and pune 
AUTOGEN | 


Follow the directions in this chapter. At certain points you will need to 
refer to the VMS installation and operations guide for your VAX computer. 


Turning On the System 


If necessary, read the section “Turning on the System” in the VMS 
installation and operations guide for your VAX computer. Once the system 
is turned on, go to Section 2.3 in this chapter to prepare the disk and tape 
drives. : | 


Preparing the Disk and Tape Drives 


Set up the disk and tape drives you use during the installation by doing 
the following: 


1 Decide which drive will hold the distribution tape or disk and which 
drive will hold the system disk. Determine the device names for 
each drive. Write these names on a piece of paper. You will need 
this information throughout the installation. If you need help with 
the device names for your system, refer to the VMS installation and 
operations guide for your VAX computer. 


Do not place the distribution media in the drive at this point. 


2 Follow this step only if the system disk is on an HSC drive in a 
VAXcluster environment. Otherwise, go to step 3. 


Make sure that both the CI device and the HSC50 or HSC70 are 
turned on, and are on line. Obtain the HSC name from the system 
manager, or use the following procedure: 


a. Press CTRL/C at the HSC console terminal. 


b. Enter the following command at the HSC> prompt and press 
RETURN: 


HSC> SHOW SYSTEM 


Installing the VMS Operating System and DECwindows Software 


2.3 Preparing the Disk and Tape Drives 


The information displayed includes the name of the HSC. For 
example: 


19-APR-1990 15:00:00.00 Boot:19-Apr-1990 11:31:11.41 Up: 51:00 
Version V350 System ID: %xX000000011 Name: TROUT 


DISK allocation class = 1 TAPE allocation class = 0 
Start command file Disabled 


SETSHO - Program Exit 
For more information, see the HSC User Guide. 


3 Place a scratch disk in the drive for the system disk (unless the system 
disk is fixed). 


Spin up the system disk but do not write-protect it. 
To boot standalone BACKUP, go to Section 2.4. 


2.4 Booting Standalone BACKUP 


Note the following about VMS Version 5.2 kits: 


-@ ‘There are three tape cartridges in a tape cartridge kit. Standalone 


BACKUP is on the same tape cartridge as VMS DECwindows. This 
tape cartridge is labeled VMS V5.2 BIN TK50 2/2 S/A BKUP & 
DECWINDOWS. To start the installation, put this tape cartridge in 
the appropriate drive. 


e If your VMS kit contains standalone BACKUP on either RX33 or RX50 
diskettes, the number of diskettes has increased. The RX50 kit now 
contains five diskettes and the RX383 kit now contains three diskettes. 


Follow the instructions in “Booting Standalone BACKUP” in the VMS 
installation and operations guide for your VAX computer. After you boot 
standalone BACKUP, return to this guide for the next step in the VMS 
Version 5.2 installation procedure. 


After you boot standalone BACKUP you should see the following display: 


SBACKUP-I-IDENT, standalone BACKUP V5.2; the date is 19-APR-1990 15:00 


Note: 


Go to Section 2.5 in this chapter to create the system disk. 


If you have a tape cartridge kit, remove the VMS DECwindows 
tape cartridge from the drive after you boot standalone BACKUP. 
Put the tape cartridge that contains the VMS operating system in 


the drive. The VMS tape cartridge is labeled VMS BIN TK50 1/2 


BINARY. 
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2.5 Creating a System Disk 


This section describes the steps for transferring the VMS files from the 
distribution kit to your system disk. The VMS files are stored on the 
distribution kit as three save sets: required, library, and optional+ 


The instructions refer to the source-drive and the target-drive where: 


1 


The source-drive is the drive that holds the distribution kit. 

The target-drive is the drive that holds the system disk. 

If you have not already done so, determine the device names for the 
source-drive and the target-drive. Write these names on a piece of 
paper. You will need this information throughout the installation. If 


either the source-drive or the target-drive are connected to an HSC, 
you also need the name of the HSC. 


If you need help with the device names for your system, refer to the 
VMS installation and operations guide for your VAX computer. 


Each piece of media in the distribution kit has a label that indicates 
its contents. Place the media that contains the VMS operating system 
in the source-drive. 


To transfer the VMS required save set to your system disk, use the 
BACKUP command in the following format: 


$ BACKUP/VERIFY [hsc-name] source-drive:VMS052.B/SAVE_SET [hsc-name]target-drive: 


Substitute the appropriate device names for source-drive and target- 
drive. Make sure you put a colon (:) after each device name and that 
you use zeros in the device names and in VMS052. 


For example, if your system has the following configuration: 


e A source-drive that is a TU80 magnetic tape drive with a device 
name of MSAO0 


e A target-drive that is an RA6O disk drive with a device n 


DJAI — 
Enter the following command and press RETURN: 
$ BACKUP/VERIFY MSA0O:VMS052.B/SAVE_ SET DJAIL: 
Suppose your system has the following configuration: 


¢ A source-drive that is a tape cartridge drive with a device name of 
MUC6 


e 6A target-drive that is an RA81 disk drive with a device name of 
DUAI and an HSC name of YOURS 


Enter the following command and press RETURN: 


S BACKUP/VERIFY MUC6:VMS052.B/ SAVE SET YOURSS$DUAIL: 


1 If the distribution media is some type of disk, the VMS save sets are in the [0,0] directory. They must be in 
this directory for the installation procedure to work. 
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The VMS required save set is transferred from the distribution kit 

to the system disk.2 The amount of time this takes varies depending 
upon the system you have. During the process the procedure displays 
the following message: 


SBACKUP-I-STARTVERIFY, starting verification pass 


This message indicates that the required save set has been transferred 
to the system disk and the files are being checked for errors. In 
approximately 15 minutes, the procedure displays the following 
message: 

SBACKUP-I-PROCDONE, Operation completed. Processing finished at 19-APR-1990 15:00 


If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


4 Stop the system and boot the new system disk, as described in the 
installation and operations guide for your VAX computer. After you 
boot the new system disk, return to this guide for the next step in the 
VMS Version 5.2 installation procedure. 


5 When the boot is complete, the procedure displays a message and asks 
you for the date and time. Enter the date and time using the 24-hour 
clock format and press RETURN. For example: 


Note: The procedure displays warning messages, similar to the 
following, that the VMS license is not registered. Continue 
with the installation procedure. Follow the instructions for 
registering the VMS license after you finish the installation. 


VAX/VMS Version BI52-xxx Major version id = 01 Minor version id = 00 
VAX/VMS Version V5.2 Installation Procedure 


Model: VAX 8800 
System device: RA60 
Free blocks: XXXXXX 
Please enter the date and time (DD-MMM-YYYY HH:MM): 19-APR-1990 15:00 
%SET-~I-NEWAUDSERV, identification of new audit server process is 00000027 
%LICENSE-F-EMTLDB, license database contains no license records 
S$LICENSE-E-NOAUTH, DEC VAX-VMS use is not authorized on this node 
-%SLICENSE-F-NOLICENSE, no license is active for this software product 
-SLICENSE-I-SYSMGR, please see your system manager 
Startup processing continuing... 


SEESSSESESESSES OPCOM 19-APR-1990 15:00:00.00 %%%%%%%%%%% 


* 


6 The procedure asks for the volume label of the system disk. A volume 
label is the name the VMS operating system uses to refer to the 
system disk. You can press RETURN to accept the default volume 
label, VAXVMSRL052, or you can enter a volume label of your choice. 
The volume label can be 1 to 12 characters long; do not use spaces. 
For example: 


2 The BACKUP command creates a system disk that includes a set of volume parameters provided by Digital, 
including a CLUSTER_SIZE (disk access scheme) of one. For more information, see the VMS installation 
and operations guide for your VAX computer. 
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If this system disk is to be used in a cluster with multiple 

system disks, then each system disk must have a unique volume label. 
Any nodes having system disks with duplicate volume labels will fail 
to boot into the cluster. 


You may indicate a volume label of 1 to 12-characters in length. If you 
wish to use the default name of VAXVMSRLO52 just press RETURN in response to 
the next question. 


Enter the volume label for this system disk (no spaces) [VAXVMSRL052]: SYSDSK 
The procedure asks which drive holds the distribution kit. Enter the 
device name of the source-drive. For example, suppose the source-drive 


is a tape cartridge drive with a device name of MUAO. Enter the 
following and press RETURN: 


Enter the name of the drive holding the VMS distribution media: MUAO 
* Is the VMS media ready to be mounted? [N]} YES 


SMOUNT-I-MOUNTED, VMS052 mounted on _MUAO: 


The full VMS kit will be installed on this system dis! 
The following (with approximate sizes) will be provided: 
VMS library ~ 26500 blocks 
VMS optional - 14500 blocks 


You can provide DECwindows support now, or you can use the 
DECWSTAILOR utility to provide or remove DECwindows support 
after the installation. 


NOTE: Some media, TK50s in particular, can be very slow when 
tailoring on files. You might want to provide DECwindows 
options now and tailor off unwanted files later. 


*Do you want to provide optional DECwindows support? (Y/N) 


If you do not want to install VMS DECwindows software, type N (for 
NO), press RETURN, and go to step 8. 


If you want to install VMS DECwindows software, type Y (for YES) 
and press RETURN. You can install either the complete DECwindows 
kit or selected portions of it. The procedure displays information about 
the amount of space you need on the system disk for each option. As 
you choose your options, the procedure calculates the amount of space 
that would be left on the system disk. The procedure will give you the 
opportunity to change your mind before proceeding. 


Consider the following before you select the VMS DECwindows options 
that you want to install: | 


¢ Applications filese—VMS DECwindows provides a variety of 
applications; including the following: Bookreader, Calculator, 
Calendar, Cardfiler, Clock, DDIF Document Viewer, EVE Text 
Editor, FileView, Mail, Notepad Text Editor, Paint Graphics Editor, 
PostScript Previewer, DECterm, the Session Manager, and the Icon 
Box. If you are installing VMS DECwindows on a VAXstation, you 
need these files. 


e Device support files—If you are installing VMS DECwindows on 
a VAXstation or in a cluster that includes VAXstations, you need 
these files. Otherwise you do not need them. 


e 100 dots-per-inch (100DPD video font files—All VMS DECwindows 
applications run with 75 dots per inch (dpi) fonts. Certain 
applications take advantage of 100 dpi fonts. 


Installing the VMS Operating System and DECwindows Software 


2.5 Creating a System Disk 


e Programming support files—The VMS DECwindows programming 
support files are needed only to develop applications and are 
not required to run VMS DECwindows applications. Support 
files are supplied for the following VAX programming languages: 
Ada, BASIC, BLISS, C, FORTRAN, MACRO, Pascal, and PL/1. 
In addition, support files are supplied for programming in the 
C language using conventions and standards developed at the 
Massachusetts Institute of Technology. 


The procedure displays the following messages: 


Restoring VMS library saveset. 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring VMS optional saveset. 
SBACKUP-I-STARTVERIFY, starting verification pass 


The optional VMS files are listed in Appendix C. After you finish the 
installation, you can use VMSTAILOR to remove the VMS files you do 
not need. For more information on VMSTAILOR, see Chapter 3. 


If you are installing VMS DECwindows software, go to Section 2.6. 
If you are not installing VMS DECwindows software, go to Section 2.7. 


2.6 Installing VMS DECwindows Software 


If you are installing VMS DECwindows software, use the following 
procedure: 


1 


_ Note: 


Remove the media that contains the VMS operating system from the 
source-drive when you see a message similar to the following: 


You may now remove the VMS distribution kit from MUAO:. 


Put the DECwindows distribution kit in the drive. 


_ Put the tape or disk that contains the VMS DECwindows software in 


the source-drive. 


If you have either an RLO2 or RKO7 kit, DECwindows is on a 
magnetic tape. If you have an RX33 kit, DECwindows is on a 
tape cartridge. Check the labels and put the appropriate piece 
of media in the appropriate drive. 


Enter the device name of the source-drive and press RETURN. For 
example: 


* Enter name of the drive holding the DECwindows distribution media: MUAO 
* Is the DECwindows media ready to be mounted? [N] YES 


The procedure displays messages similar to the following: 


SsMOUNT-I-MOUNTED, DECW52 mounted on MUAOQ: 


Restoring DECwindows applications saveset... 


SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows device support saveset... 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows 75DPI fonts saveset... 
SBACKUP-I-STARTVERIFY, starting verification pass 
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Restoring DECwindows 100DPI fonts saveset... 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows programming support saveset... 
SBACKUP-I~-STARTVERIFY, starting verification pass 


The optional VMS DECwindows files are listed in Appendix D. After 


you finish the installation, you can use DECW$TAILOR to remove the 


VMS DECwindows files you do not need. For more information on 
DECWS$TAILOR, see Chapter 3. 


To continue the installation procedure, go to Section 2.7. 


Becoming a VAXcluster Member 


The installation procedure now asks you whether you are installing the 
VMS operating system in a VAXcluster environment. If you are installing 
the VMS operating system in a VAXcluster environment, the procedure 
then asks a series of questions about your configuration. 


1 


The procedure displays the following messages: 


Creating [VMSSCOMMON] directory tree 


In a cluster, you can run multiple systems sharing all files except 


PAGEFILE.SYS, 


SWAPFILE.SYS, SYSDUMP.DMP and VAXVMSSYS.PAR. 


Will this node be a cluster member? (Y/N) 


Note: 


If you are installing the VMS operating system on a standalone 
system, type N (for NO), press RETURN, and go to the next step. 


If you are installing the VMS operating system in a VAXcluster 
environment, type Y (FOR YES) and press RETURN. If you answer 
YES to the VAXcluster question, you must have a VAXcluster license. 


If you installed VMS DECwindows, at some point the procedure 
will ask the following question: 


. 
‘s y Hh 
vo! want DECwi ndows a 


Do a “ we a Lk en Oe v¥ aw as. nus 


1u7 J/aTN 
{L/iN} 


Depending on your preference, type Y (for YES) or N (for NO) 
and press RETURN. If you type Y (for YES), the procedure sets 


the SYSGEN WINDOW_SYSTEM parameter to one. 


If you are installing the VMS operating system in a VAXcluster 
environment, go to step 3. 


If you are installing the VMS operating system on a standalone 
system, go to step 5. 


The procedure displays the following message: 
Now configuring system to be a cluster member. 


Determine the type of cluster configuration you want to create 
(configuration types are described in the VMS VAXcluster Manual). 
Table 2-1 lists the questions you are asked if you want a CI-only 
configuration. Table 2—2 lists the questions you are asked if you want 
a local area VAXcluster or a mixed-interconnect configuration. Typical 
responses are explained in the table. 
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Table 2-1 Installation Questions for Cl-Only Configurations 








Questio How to Respond 
Will this node be a cluster member (Y/N)? Enter Y. 
What is the node’s DECnet node name? Enter the DECnet node name—for example, 


JUPITR. The DECnet node name may be 
from 1 to 6 alphanumeric characters in 
length and may not include dollar signs or 
underscores. 


_ What is the node’s DECnet node address? Enter the DECnet node address—for 


example, 2.2 


Will the Ethernet be used for cluster communications (Y/N)? Enter N. The Ethernet is not used for cluster 
(SCS internode) communications in Ci-only 
configurations. 


Will JUPITR be a disk server (Y/N)? Enter Y or N, depending on your 
configuration requirements. Refer to the 
VMS VAXcluster Manual for information on 
served cluster disks. 


Enter a value for JUPITR’s ALLOCLASS parameter: If the system is connected to a dual-ported 
disk, enter the appropriate allocation class 
value (it must be a value between 1 and 
255). Otherwise, enter 0. 


Does this cluster contain a quorum disk (Y/N)? Enter Y or N, depending on your 
configuration. If you enter Y, the procedure 
asks for the name of the quorum disk. Enter 
the device name of the quorum disk. 





Table 2-2 Installation Questions for Local Area and Mixed-Interconnect Configurations 





Question How to Respond 
Will this node be a cluster member (Y/N)? Enter Y. 
What is the node’s DECnet node name? Enter the DECnet node name—for example, 


JUPITR. The DECnet node name may be 
from 1 to 6 alphanumeric characters in 
length and may not include dollar signs or 


underscores. 

What is the node’s DECnet node address? Enter the DECnet node address—for 
example, 2.2 

Will the Ethernet be used for cluster communications (Y/N)? Enter Y. The Ethernet is required for cluster 


(SCS internode) communications in local | 
area and mixed-interconnect configurations. 


Enter this cluster’s group number: Enter a number in the range from 1-4095 or 
61440-65535. 
Enter this cluster’s password: Enter the cluster password. The password 


must be from 1 to 31 alphanumeric 
characters in length and may include dollar 
signs and underscores. 


(continued on next page) 
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Table 2-2 (Cont.) 


Installation Questions for Local Area and Mixed-Interconnect Configurations 





Question 


How to Respond 


Re-enter this cluster’s password for verification: Re-enter the password. 


Will JUPITR be a disk server (Y/N)? 


Wiil JUPITR serve HSC disks (Y)? 


Enter a value for JUPITR’s ALLOCLASS parameter: 


Does this cluster contain a quorum disk (Y/N)? 


AUTOGEN 
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Enter Y. In local area and mixed-interconnect 
configurations, the system disk is always 
served to the cluster. Refer to the VMS 
VAXcluster Manual for information on served 
cluster disks. 


Enter a response appropriate for your 
configuration. 


Enter the appropriate allocation class 
value. If you have a mixed-interconnect 
configuration, the value must be between 1 
and 255; you cannot enter 0. 


Enter Y or N, depending on your 
configuration. If you enter Y, the procedure 
asks for the name of the quorum disk. Enter 
the device name of the quorum disk. 


5 The procedure displays a message similar to the following: 


You may now remove the distribution kit from _SMUAO: 


Remove the distribution media from the drive and go to Section 2.8. 


Setting Passwords, installing the AEOTY Update, and Running 


Follow the directions in this section to set passwords, install the 
mandatory update, and run AUTOGEN. AUTOGEN evaluates your 
hardware configuration and estimates typical workloads. It then sets 


am nin ee par ace 


system parameters, the sizes of the page, swap, and dump files, and the 
contents of VMSIMAGES.DAT. When AUTOGEN finishes, the installation 
procedure is complete. 


1 


The procedure asks you for new passwords for the SYSTEM, SYSTEST, 
and FIELD accounts. Passwords must be at least eight characters in 
length; they do not appear on the display. Press RETURN after you 
enter each one. After you enter the passwords, the procedure checks 
each one to make sure it meets the requirements for a good password. 
For example: 


Now we will ask you for passwords for the following accounts: 
SYSTEM, SYSTEST, FIELD 


Passwords must be a minimum of 8 characters in length. All passwords 
will be checked and verified. Any passwords that can be guessed easily 
will not be accepted. 


Enter password for SYSTEM: 
Re-enter for verification: 


SUAF-I-MDFYMSG, user record(s) updated 
SVMS~I-PWD_OKAY, account password for SYSTEM verified 


Enter password for SYSTEST: 
Re-enter for verification: 
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SUAF-I-MDFYMSG, user record(s) updated 
%VMS-I-PWD_OKAY, account password for SYSTEST verified 


The SYSTEST_CLIG account will be disabled. You must re-enable 
it before running UETP but do not assign a password. 


Enter password for FIELD: 
Re-enter for verification: 


SUAF-I-MDFYMSG, user record(s) updated 
$VMS-I-PWD_OKAY, account password for FIELD verified 


If you do not get password errors, go to step 2. 


If you enter a password incorrectly or if the password is too easy to 
guess, the procedure displays error messages similar to the following: 


SVMS-I-PWD_INVALID, account password for SYSTEST is invalid 
SVMS-I-PWD WEAK, password is too easy to guess 


Because of the preceding error, you must take action to secure this account. 
You must either disable this account, change its password, or do both. 


When the procedure asks if you want to disable the account, type N 
(for NO) and press RETURN. When the procedure asks if you want 
to enter a new password, type Y (for YES) and press RETURN. Then 
enter a new password. For example: 

Do you want to disable this account (Y/N)? 8 

Do you want to- change the account password (Y/N)? * 

You must now select a new primary password for the SYSTEST account. The 


password you select must be at least 8 characters in length an may not 
be the same as the name of the account: 


New password: 
Verification: 


SUAF-I-MDFYMSG, user record(s) updated 
%VMS-I-PWD_SET, primary password for account SYSTEST set 


After you have entered the passwords, the procedure creates your 
RIGHTS database and displays the following message: 


Creating RIGHTS database file. SYSSSYSTEM:RIGHTSLIST.DAT 
Ignore any "SSYSTEM-F-DUPIDENT, duplicate identifier" errors 


e 


After the procedure creates the RIGHTS database, it displays the 


following messages: 


After the installation finishes, you may want to do one or more of the 
following tasks: 


© DECOMPRESS THE SYSTEM LIBRARIES - For space considerations, many of 


the system libraries are shipped in a data compressed format. If you 
have enough disk space, you may decompress them for faster access. To 


_ data expand the libraries, type: 


S$ @SYSSUPDATE:LIBDECOMP .COM 


If you choose not to decompress these libraries there will be a 
negative impact on the performance of the HELP and LINK commands. 


o BUILD A STANDALONE BACKUP KIT - You can build a standalone backup kit 
using the procedure described in your VMS installation and operations 
guide which is supplied with your VAX computer. 


© TAILOR THE SYSTEM DISK - You may review the files provided or 

not provided during this installation. IF you find there are files 

you want to remove from the system disk (TAILOR OFF) or files you want 
to add (TAILOR ON), then use the following utilities to perform the 
desired tailoring. 


VMS tailoring: . $ RUN SYSSUPDATE: VMSTAILOR 
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DECwindows tailoring:  $ RUN SYSSUPDATE:DECWSTAILOR 
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Continuing with VAX/VMS V5.2 installation procedure. 
Configuring all devices on the system. 


You must now install the mandatory update, which can be found 
on a separate distribution volume. 


The procedure asks you for the device name of the drive that contains 
the mandatory update. Type the device name of the drive where you 
will put the piece of media that contains the mandatory update. 


For example, if the mandatory update is on the console drive names 
CSA1, enter the following and press RETURN: 


*Where will the distribution volumes be mounted: CSAI1 
The procedure displays the following message: 


Please mount the first volume of the set on CSAI1:. 
*Are you ready? 


Place the media labeled VMS V5.2 MANDATORY UPDATE in the 
appropriate drive. When you are ready to continue, type Y and press 
RETURN. The procedure displays the following series of messages: 
SMOUNT-I-MOUNTED, VMSMUP mounted on CSAIL: 
The following products will be processed: 

VMSMUP V5.2 

Beginning installation of VMSMUP V5.2 at 15:00 

SVMSINSTAL-I-RESTORE, Restoring product saveset A... 


Installing VMS V52 mandatory update 


If the installation procedure cannot determine the system 
communications services (SCS) node name for your system, it prompts 
you as follows: 


Unable to determine the SCS node name to be used for the VMS 
license. If the machine will be a member of a cluster, 
please enter the SCS node name at the prompt. If it will not 
be a cluster member, press the RETURN key. 


SCS Node Name: 


Follow the instructions in the display and either press the RETURN 
key or enter the SCS node name. 


If there is more than one piece of media containing the mandatory 
update, you will be asked to switch them at some point during the 
procedure. Read the screen displays. When the procedure finishes, it 
displays a message similar to the following: 


Installation of VMSMUP V5.2 completed at 15:00 
VMSINSTAL procedure done at 15:02 
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| Note: 


AUTOGEN runs and displays the following series of messages: 


Running AUTOGEN to compute new SYSGEN parameters. 


An attempt may be made to re-size the pagefile or swapfile. If 
there is insufficient room on the disk, the recommended size is 
displayed with a message that the file should be created or 
extended manually by the system manager later on. 


Running AUTOGEN - Please wait. 


After AUTOGEN finishes, the procedure displays a series of shutdown 
messages that begins like this: 


The system is shutting down to allow the system to boot with the 
generated site-specific parameters and installed images. 


The system will automatically reboot after the shutdown and the upgrade 
will be complete. 


SHUTDOWN -~- Perform an Orderly System Shutdown 


After the system shuts down, the procedure tries to reboot the new 
system disk. If the system does not reboot automatically, enter the 
appropriate BOOT command for your system. For information on 
booting, refer to the VMS installation and operations guide for your 
VAX computer. Then return to this guide for the next step in the VMS 
Version 5.2 installation procedure. 


For example, suppose you have a VAX-11/780 and the system disk is 
on an RA6O disk drive with a unit number of one. Enter the following 
command and press RETURN: 


o> 6B DUAL 
After the system reboots, the procedure displays the following message: 


The procedure might display warning messages that the VMS 
license must be registered. Be sure to register this license 


when the installation procedure finishes, as described in 


Chapter 3. 


VAX/VMS Version V5.2 Major version id = 01 Minor version id = 00 
KAEKEKEKKKEKEKKKKREKKEKKEKEKKKKEKRKK KKK KEKE KKK KEK KKK KKKKKKKE KKK KEK KE KKKKKAEKE 
VAX/VMS V5.2 
You have SUCCESSFULLY installed the VMS operating system. 


The system is now executing the STARTUP procedure. Please 
await the completion of STARTUP before logging into the 
system (approximately three minutes). 


KEEKKKEKREKEKEKRKEKREKRKRKRKKKRKKKKKEKEKKREKKRREKREKREKEKEKKEKREKRKEKRKEKKRKEKKKEREKERE 


The VAX/VMS system is now executing the system startup procedure. 


SSSSSSSSSS% + OPCOM 19-APR-1990 15:00.00.00 %%%%%%%%%S%% 
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Finally, the procedure displays informational messages as well as 
accounting information. For example: 
The VAX/VMS system is now executing the system startup commands. 


SSET-I-INTSET, login interactive limit=64, current interactive value = 0 
19-APR-1990 15:00:00.00 


SYSTEM job terminated at 19-APR-1990 15:00:00.00 
Accounting information: 
Buffered I/O count: 859 Peak working set size: 565 
Direct I/O count: 478 Peak virtual size: 2570 
Page faults: 5003 Mounted volumes: 0 
Charged CPU time: 0 00:00:55.23 Elapsed time: 0 00:01:31.24 


At this point the VMS operating system is running. 


Press RETURN. The system asks you for the user name and password. 
Log into the SYSTEM account so that you can perform certain post- 
installation tasks. For example: 


Welcome to VAX/VMS V5.2 


USERNAME: SYSTEM 
PASSWORD: 


Welcome to VAX/VMS Version V5.2 


If you forget the password, follow the instructions for performing an 
emergency startup in the Guide to Setting Up a VMS System. 


There are several things you must do before you can use the system. 
For complete information, see Chapter 3. 


3 After Installing VMS 


After you have installed the VMS operating system, you need to perform 
several important tasks to prepare the system for operation. This chapter 
tells you what the tasks are, whether they are optional or required, and 
the order in which you perform them. The following list summarizes the 
tasks that are described in this chapter: 


1 Registering your licenses—You must register the VMS license that 
came with the software. You must also register the licenses you have 
for any system integrated products that you purchased. 


2 Starting DECwindows—After you register the VMS license you can 
start DECwindows on the system. 


3 Customizing the system—Depending on whether you have a 
standalone system or a system that is part of a VAXcluster 
environment, there are several things you must do. 


4 Testing the system—Once you have customized the system, run the 
VMS User Environment Test Package (UETP) to test the system. 


5 Decompressing the system libraries—After you test the system, you 
can decompress the system libraries. 


6 Removing unwanted files from the system disk —You can free up space 
on the system disk by removing the VMS and DECwindows files that 
you do not need. 


7 Backing up the system disk—To protect all the work you have just 
done, make a backup copy of the system disk. 


8 Running AUTOGEN—AUTOGEN fine tunes the system parameters 
for you. 





3.1 Registering Your Licenses 


The VMS license lets you use the VMS operating system. You must 
register this license. 


After you register the VMS license, you must register the licenses for any 
of the following system integrated products you have purchased: 


e VAXclusters 
e DECnet-VAX 
e RMS Journaling 


¢ Volume Shadowing 


For step-by-step instructions on registering licenses, see the current 
version of the VMS Release Notes. 
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3.2 Starting VMS DECwindows Software 


After you register the VMS license and reboot the system, DECwindows 
starts automatically (if you installed it). However, if you intend to install 
DECnet VAX, you need to edit SYS$SYSROOT:[SYSMGRISYSTARTUP_ 
V5.COM. This file contains the following command: 


$ DEFINE DECWSIGNORE_DECNET TRUE 


If you are not going to install DECnet VAX or have not yet installed it, 
this command tells DECwindows not to wait for DECnet. 


Once you have installed and configured DECnet VAX, you must edit 

the commands in SYS$SYSROOT:[SYSMGR]SYSTARTUP_V5.COM that 
pertain to starting the network. Choose one of the following commands to 
start the network by removing the appropriate comment delimiter (!): 


5! IF FSSEARCH ("SYSSSYSTEM:NETACP.EXE") .NES "" THEN @SYSSMANAGER:STARTNET 
$! IF FSSEARCH ("SYSSSYSTEM:NETACP.EXE") .NES "" THEN SUBMIT SYSSMANAGER:STARTNET.COM 


Then, add a comment delimiter (!) to the following command: 
$! DEFINE DECWSIGNORE_DECNET TRUE 


For more information on starting and customizing VMS DECwindows 
software, see Appendix B. 





3.3 Customizing the System 


2 


You must customize the system disk so that it automatically performs 
certain tasks when you boot. In addition, if your VAX computer is part 
of a VAXcluster environment, you must prepare the cluster operating 
environment and build the cluster. 


For instructions on customizing the system, read the following 
documentation (in the order given): 


1. Read the chapter on booting in the installation and operations guide 
-for your VAX computer. This chapter explains the different ways to 
boot the system. It also tells you how to shut down the system. 


2 Ifthe computer is part of a VAXcluster environment, read the VMS 
VAXcluster Manual for further information on setting up a cluster. 


3 If you have a standalone system, read the Guide to Setting Up a VMS 
System for instructions on customizing and using your system. You | 
will find information on the following tasks: 


a. Editing the template files SYCONFIG.COM, SYLOGICALS.COM, 
- SYLOGIN.COM, and SYSTARTUP_V5.COM 


b. Setting up user accounts 


Cc. Adjusting system parameters 
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3.4 Testing the System 


You must run the User Environment Test Package (UETP) to verify the 
installation. For complete information, see Chapter 9. Note that UETP 
needs at least 1200 free blocks on the system disk. 


3.5 Decompressing the System Libraries 


Decompressing the system libraries gives the system faster access to 

the libraries. The decompressed libraries require approximately 7000 
additional blocks of disk space. To find out how much disk space you have, 
enter the following command and press RETURN: 


§ SHOW DEVICE SYSSSYSDEVICE 


If you have enough room on the disk, you can decompress the libraries. 
The decompression process takes approximately a half hour. Log into the 
SYSTEM account, enter the following command, and press RETURN: 


$ @SYSSUPDATE: LIBDECOMP .COM 





3.6 Removing Unwanted Files 


Note: 


Read this section if you want to remove some of the VMS operating system 
and DECwindows files that you do not need from the system disk. For 
example, if you are not running DECnet-VAX, you do not need the network 
support files. You can remove unwanted files with the VMSTAILOR 
program. Log into the SYSTEM account, enter the following command, 
and press RETURN: 


$ RUN SYSSUPDATE: VMSTAILOR 


The VMSTAILOR program asks you if you want to tailor files ON or OFF. 
Type OFF to remove unwanted files. 


The VMSTAILOR program lists each group of files and its size in blocks. 
Files are grouped according to their function. For example, all the files 
required for cluster support are in one group. A file group is made up of 
many small subgroups. You can eliminate an entire group of files, or you 
can eliminate one or more of its subgroups. 


Decide which file groups or subgroups you do not need to support your 
system. The VMSTAILOR program displays step-by-step instructions that 
are easy to follow. 


VMSTAILOR displays the names of the files it deletes. After it finishes, 
AUTOGEN runs automatically to make the adjustments that are 
necessary after system files are deleted. 


You can use VMSTAILOR at any time to delete or add groups of 
VMS files to the system disk. After adding files to the system disk, 
you should apply any updates that affect them. 
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For example, suppose you do not need the VMS Version 5.2 MAIL 
utility and you run VMSTAILOR to remove those files. Later on, 
if you decide you want to use MAIL, you can run VMSTAILOR to 
return the MAIL files to the system disk. You then apply any VMS 
update that has occurred since Version 5.2 that affected the MAIL 
utility. 


To remove DECwindows files from the system disk, enter the following 
command and press RETURN: 


$ RUN SYSSUPDATE:DECWSTAILOR 
The DECW$TAILOR program is similar to the VMSTAILOR program. 


Note: To start VMS DECwindows, reboot the system conversationally 
and check the SYSGEN parameter WINDOW_SYSTEM. To start 
VMS DECwindows software, set this parameter to one. Also, if you 
tailor on or off device support files, the system will reboot. 


When tailoring VMS DECwindows files, consider the following: 


¢ Applications files—VMS DECwindows provides a variety of 
applications; including the following: Bookreader, Calculator, 
Calendar, Cardfiler, Clock, DDIF Document Viewer, EVE Text Editor, 
FileView, Mail, Notepad Text Editor, Paint Graphics Editor, PostScript 
Previewer, DECterm, the Session Manager, and the Icon Box. If you 
are installing VMS DECwindows on a VAXstation, you need these files. 


¢ Device support files—If you are installing VMS DECwindows on a 
VAXstation or in a cluster that includes VAXstations, you need these 
files. Otherwise you do not need them. 


¢ 100 dots-per-inch (100DPI) video font files—All VMS DECwindows 
applications run with 75 dots per inch (dpi) fonts. Certain applications 
take advantage of 100 dpi fonts. 


¢ Programming support files—The VMS DECwindows programming 
support files are needed only to develop applications and are not / 
required to run VMS DECwindows applications. Support files \ 
are supplied for the following VAX programming languages: Ada, 
BASIC, BLISS, C, FORTRAN, MACRO, Pascal, and PL/1. In addition, 
support files are supplied for programming in the C language using 
conventions and standards developed at the Massachusetts Institute of 
Technology. 


3.7 Backing Up the System Disk 


Now that you have spent time customizing the system, protect your work 
by making a backup copy of the system disk. Digital recommends that you 
perform the following operations: 


¢ Make a standalone backup kit 
¢ Back up the system disk 
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For complete information on these operations, see the operations guide for 
your VAX computer. Once you have backed up the system disk, install any 
software products that you have purchased. Follow the directions given in 
the software product manuals. 





Running AUTOGEN 


Run AUTOGEN FEEDBACK and reboot the system after 24 hours of 
operation, and again two workdays later. AUTOGEN sets the values of 
system parameters and the sizes of the page and swap files according 
to the system’s workload. Digital recommends that you run AUTOGEN 
from SAVPARAMS through TESTFILES on a weekly basis and examine 
AGEN$FEEDBACK.REPORT to determine the need for additional 
changes. 


Hardcoded values in MODPARAMS.DAT affect AUTOGEN’s calculations 
of the feedback parameters. For AUTOGEN FEEDBACK to properly 
calculate values, you should replace the hardcoded values in 
MODPARAMS.DAT with MIN_ values. 


For information on using AUTOGEN, see the Guide to Setting Up a VMS 
System. 
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Part Il describes how to upgrade to Version 5.2 of the VMS operating system. 
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4 Overview of the Upgrade Procedure 


Note: 


Use the upgrade procedure when you are running a standard version 

of the VMS operating system and you want to obtain a higher version. 
The upgrade procedure does not initialize the system disk (as does the 
installation procedure). This means you can obtain the latest version of 
the operating system while keeping your user files and optional software 
intact. 


The Version 5.2 upgrade procedure provides new files and 
directories under [VMS$COMMON...]. If you had any special 
protections and ACLs before the upgrade, you need to reapply 
them to re-establish the security environment you previously had. 


The Version 5.2 upgrade procedure also leaves your VMS license intact. 
You do not need to reinstall the VMS license after you upgrade. (See 

the VMS Version 5.2 Release Notes for detailed information on license 
management for VMS Version 5.2. For example, in VMS Version 5.2 you 
must register your VAXcluster license before you can use your VAXcluster 
software.) 


The Version 5.2 upgrade procedure gives you the opportunity to install 
VMS DECwindows software on the system disk. 


Your system must be running at least Version 5.0 of the VMS operating 
system. For example, you can upgrade to Version 5.2 of the VMS operating 
system from any of the following versions (or related hardware releases): 


VMS Version 5.0 
VMS Version 5.0-1 
VMS Version 5.0-2 
VMS Version 5.1 
VMS Version 5.1-1 


If your system is running an earlier version, such as Version 4.7, you must 
upgrade to Version 5.0 of the VMS operating system first. For a Version 
5.2 rolling upgrade, all systems in the VAXcluster environment must be 
running at least Version 5.1 of the VMS operating system. 


To perform a successful upgrade, you must understand the basic 
operations of the VAX computer that you are upgrading. Refer to the 
VMS installation and operations guide for your VAX computer. If you have 
a VAXcluster environment, read the VMS VAXcluster Manual. 


This chapter describes what happens during the upgrade procedure. It 
also tells you what you need and lists some restrictions. 
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4.1 What Happens During an Upgrade 


When you upgrade the VMS operating system, the upgrade procedure does 
the following: 





1 Makes room for the upgrade by purging and deleting select VMS and 
VMS DECwindows files, but leaves all the user files intact 

2 ‘Transfers the VMS and VMS DECwindows files from the distribution 
media to the system disk 

Note: The upgrade puts the most recent versions of the VMS files in 

SYSSCOMMON. 

3 Merges the old and the new VMS and VMS DECwindows files 
Cleans up files and structures uséd only during the upgrade 

4.2 Cautions and Restrictions 
You must be aware of the following cautions and restrictions before you 
begin the upgrade: 
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The upgrade procedure does not work across the network. 


If you have changed the names of system directories on your system 
disk, the upgrade procedure will not work correctly. Restore your 
system disk to a standard directory structure before you attempt an 
upgrade. 


You must not move the system disk or the VMS distribution kit from 
one drive to another during the upgrade. 


The upgrade procedure deletes all the operator and accounting logs. 
To save these files, move them to a user directory before you start the 
upgrade. 


Before you start the upgrade procedure in a VAXcluster environment, 
you must shut down all the nodes that boot from the system disk you 
are upgrading. 


Record the upgrade procedure on either a hardcopy terminal or a 
printer attached to the console terminal. If you do not do this, the 
screen messages will be lost. You will need a transcript in case there 
is a problem. 


The upgrade procedure is designed so that you should not have to 
reinstall most layered products after the upgrade. However, you might 
need to reinstall certain layered products because of product-specific 
installation procedures. 


For example, you must reinstall layered products that either create 
directories synonymous with system directories or use VMS-defined 
data structures. If a layered product is available (refer to Appendix §), 
yet exhibits unexpected behavior once Version 5.2 of the VMS 
operating system is running, check the VMS Version 5.2 Release 
Notes for layered product restrictions. If problems persist, contact your 
Digital representative. 


Overview of the Upgrade Procedure 
4.2 Cautions and Restrictions 


4.3 What You Need for the Upgrade 


You need the following items to perform the upgrade to Version 5.2 of the 
VMS operating system: 


e VMS Version 5.2 software distribution kit 


e If you have one of the following VAX computers, you need scratch 
console media: 


VAX 8600, 8650 

VAX 8200, 8250, 8300, 8350 
VAX—11/730 

VAX-—11/750 

VAX-—11/780, 785 


For example, if you have a VAX-11/780 or VAX-11/785, you need a 
blank RX01 floppy diskette. 


To prepare for an upgrade, follow the instructions in Chapter 5. 
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Before You Do an Upgrade 


NOTE: 


Before you do an upgrade, you need to perform several important tasks 
to prepare the system. The following list summarizes these tasks, each of 
which is described in this chapter: 


1 Understanding VMS Version 5.2—You need to read the VMS Version 
5.2 New Features Manual and VMS Version 5.2 Release Notes before 
you upgrade the system. You also need to know how to boot the system 
from [SYSF]. 


2 Backing up the system—For your protection, you must make a backup 
copy of the system disk and, in some cases, the console media. 


3 Preparing the system disk—You need to move any files that might 
affect the upgrade to a user directory and make sure that you have 
enough space on the system disk for the upgrade. You also need to 
check and set certain SYSGEN parameters. 


4 Preparing the system—You must stop all queues and, if applicable, 
shut down the network. You also need to set the system up for 
automatic restart. For some VAX computers this means modifying 
boot command procedures. 


5 Saving AUTOGEN FEEDBACK parameters 
If you are using volume-shadowed system disks, you must perform 


additional tasks before doing an upgrade. Refer to the VAX Volume 
Shadowing Manual. 


Understanding Version 5.2 of the VMS Operating System 


Before you begin the upgrade, read VMS Version 5.2 New Features Manual 
and VMS Version 5.2 Release Notes. These manuals describe the changes 
made to the VMS operating system in Version 5.2. 


During the upgrade procedure you are asked to boot the system from 
[SYSF]. Some VAX computers require a special command procedure to 
boot from [SYSF]. If you do not know how to boot from [SYSF], read 
Appendix A in this guide. 





Backup Procedures 


Digital recommends that you make a backup copy of the system disk and 
upgrade the backup copy. If there are problems, you still will have a 
working system disk. To make a backup copy of the system disk, follow 
the instructions in the VMS installation and operations guide for your 
VAX computer. 
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If you have a VAXcluster environment with more than one system disk, 
make sure the volume label on the backup copy of each system disk is 
unique. Use the SET VOLUME/LABEL command to change a volume 
label, if necessary. 


If you have one of the following VAX computers, you also must make a 
backup copy of the console media: | 


e VAX-—11/730 

¢ VAX-11/750 

e VAX-11/780, 785 

e VAX 8200, 8250, 8300, 8350 

e VAX 8600, 8650 

The upgrade procedure updates the console media for you. Use the backup 
copy of the console media during the upgrade procedure. If there are 
problems, you will still have a working copy of the console media. To 
make a backup copy of the console media, use the CONSCOPY procedure 


as described in the VMS installation and operations guide for your VAX 
computer. 





Preparing the System Disk 
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Prepare the system disk for the upgrade using the following procedure: 
1 Log into the SYSTEM account. Enter the following command: 
$ @SYSSSYSTEM: SHUTDOWN 


When the procedure asks if an automatic system reboot should be 
performed, press RETURN for NO. When the procedure is finished, 
halt the system as described in the VMS installation and operations 
guide for your VAX computer. 
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3 Boot the system from the backup copy of the system disk. If you do 
not know how to boot the system, refer to the VMS installation and 
operations guide for your VAX computer. 


4 Log into the SYSTEM account. 


The current copy of SYSUAF.DAT must be on the system disk in 
SYS$SYSTEM. Otherwise, you cannot proceed with the upgrade. If 
you have moved your copy of SYSUAF.DAT to another location, copy it 
to SYS$SYSTEM for the duration of the upgrade. 


Note: If you are doing a rolling upgrade, the shared version of 


SYSUAF.DAT is not updated. 
Move any files that you do not want changed into a user directory. 


5 To analyze the system disk for inconsistencies and errors in the file 
structure, enter the following command: 


S$ ANALYZE/DISK_ STRUCTURE SYSSSYSDEVICE 
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Ignore the following message: 
SVERIFY-I_OPENQUOTA, error opening QUOTA.SYS 


If you find any other errors on the system disk, enter the following 
command: 


Ss ANALYZE/DISK_ STRUCTURE/REPAIR SYSSSYSDEVICE 


6 Check the page file to make sure there are at least 4600 blocks. Use 
the following procedure: 


a. To find out the number of blocks in the page file, enter the 
following command: 


S @SYSSUPDATE: SWAPFILES 


The procedure displays the size of the page file and asks you to 
enter a new value, as follows: 


Enter new size for paging file: 


If the page file size (PAGEFILE.SYS) is greater than 4600 blocks, 
press RETURN. If it is less than 4600 blocks, enter 4600 and press 
RETURN. 


b. Ifthe swap and dump files are on the system disk, the procedure 
displays the sizes of each file. To keep the current values, press 
RETURN after each prompt. | 


If the swap file is not on the system disk, the procedure asks if 
you want to create one. You do not need swap and dump files on 
the system disk for the upgrade procedure. Enter the appropriate 
response for your system. 


If you changed the size of the page file or created a swap file, a 
message is displayed that tells you to reboot the system. Do not 
reboot now. You will reboot later. 


7 Check the system disk to make sure there is enough room for the 
upgrade. To determine whether you have enough room, enter the 
following command: 


$ SHOW DEVICE SYSS$SYSDEVICE 
The number of free blocks should be greater than 27,500. 


8 During the upgrade procedure you will shut down and reboot the 
system a number of times. To avoid configuring all the devices on the 
system during the reboot, set the SYSGEN parameter STARTUP_P1 
to MIN. Enter the following commands, pressing RETURN after each 
one: 


S RUN SYSSSYSTEM: SYSGEN 
SYSGEN> USE CURRENT 

SYSGEN> SET STARTUP Pl "MIN" 
SYSGEN> WRITE CURRENT 
SYSGEN> EXIT 
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9 Any SYSGEN parameters that you modified and did not enter in 


MODPARAMS.DAT are lost during the upgrade. To retain these 
parameters, enter their names in MODPARAMS.DAT and the value 
that AUTOGEN needs to add to the default minimum value. 


For example, if you modified GBLPAGES by 128 pages above the 
default, enter 128 into MODPARAMS.DAT, as follows: 


ADD_GBLPAGES=128 


When AUTOGEN runs after the upgrade it uses the values in 
MODPARAMS.DAT. | 


10 To prepare the system for the upgrade, go to Section 5.4. 





5.4 Preparing the System 


To prepare the system for the upgrade, use the following procedure: 


1 


To determine whether your system is running DECnet—VAX software, 
enter the following command: 


$ SHOW NETWORK 
If the system displays the following message, go to step 2: 
SSHOW-I-NONET, network unavailable 


If the system displays information on the status of the VAX/VMS 
network, enter the following commands to shut down the network: 
$ RUN SYSSSYSTEM:NCP 


NcP> SET EXECUTOR STATE OFF 
NCP> EXIT 


To stop all batch and print activities, enter the following command: 

$ STOP /QUEUE/MANAGER 

To avoid rebooting the system manually during the upgrade, set the 
computer to restart automatically. For some VAX computers this 
means setting one or more switches. For others, this means entering 
certain console mode commands. To determine how to enable auto 


restart, refer to the VMS installation and operations guide for your 
VAX computer. 


To activate any SYSGEN parameters that you changed (STARTUP_P1, 
for example), you must shut down and reboot the system at this point. 
Enter the following command: 


§ @SYSSSYSTEM: SHUTDOWN 


When the procedure asks if an automatic system reboot should be 
performed, type Y (for YES) and press RETURN. 


After the system reboots, log into the SYSTEM account. 


Run SYSGEN to reconfigure the devices on the system and run 
STARTUP CONFIGURE. Enter the following commands: 
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S RUN SYSSSYSTEM:SYSGEN 

SYSGEN> AUTOCONFIGURE ALL 
SYSGEN> EXIT 

S$ @SYSSSYSTEM: STARTUP CONFIGURE 


To prevent users from logging into the system during the upgrade, 
enter the following command: 


S$ SET LOGINS/INTERACTIVE=0 


Perform this step only if you are upgrading one of the following VAX 
computers: 


VAX 8530, 8550, 8810, 8820-N 
VAX 8820, 8830, 8840 


Before beginning the upgrade procedure, you must modify the boot 
command procedures, DEFBOO and dddGEN. To modify the boot 
command procedures, exit from the VMS operating system (but do not 
shut it down) and enter the appropriate console mode. Make copies of 
both of these files before you modify them. 


The VMS installation and operations guide for your VAX computer 
describes the procedures for copying and modifying DEFBOO and 
dddGEN. Use these procedures to modify DEFBOO and dddGEN so 
that they specify [SYSF] as the directory from which to boot. 


In DEFBOO, change the BOOT command, as follows: 
BOOT dddn/R5=F0000000 


In dddGEN, change the DEPOSIT command that sets boot flags in 
register 5 (R5), as follows: 


DEPOSIT R5 FQO0Q00001 


Perform this step only if you are upgrading a VAX 8200, 8250, 8300, or 
8350 computer. Before beginning the upgrade procedure from an HSC 
drive, you must modify the boot command procedure DEFBOO.CMD. 
Make a copy of the DEFBOO.CMD before you modify it. 


Appendix F describes the procedures for copying and modifying 
DEFBOO.CMD. Use this procedure to modify DEFBOO.CMD so 
that it is set up to boot from the current system disk and system root. 
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5.5 AUTOGEN FEEDBACK Parameters 
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Note: 


After the upgrade is finished, AUTOGEN runs. If it finds valid 
FEEDBACK data on your system, it tries to use AUTOGEN FEEDBACK. 
FEEDBACK data is produced by the SAVPARAMS phase of AUTOGEN 
and is stored in SYS$SYSTEM:AGEN$FEEDBACK.DAT. Valid 
FEEDBACK data is defined as follows: 


e The system was up for at least 24 hours when the FEEDBACK data 
was gathered 


e The FEEDBACK data is not over 30 days old 


If your FEEDBACK data is NOT valid, AUTOGEN will run 
WITHOUT FEEDBACK (all previous FEEDBACK generated 
parameters will be replaced by the AUTOGEN NOFEEDBACK 
calculations). 


To insure that AUTOGEN FEEDBACK will run after the upgrade and 
mandatory update, do the following: 


1 Check the validity of your current FEEDBACK data by entering the 
following command: 


S$ @SYSSUPDATE:AUTOGEN GETDATA TESTFILES 


This command is for test purposes and does not result in the 
modification of SYSGEN parameters or changes to the page and 
swap files. If your current FEEDBACK is valid, AUTOGEN will use it 
during the upgrade. 


AUTOGEN will issue several warnings if your current FEEDBACK 
data is invalid. If your current FEEDBACK data is invalid, go to 
step 2. 


2 If your current FEEDBACK is invalid, you can generate new 
FEEDBACK data (assuming your system was up for at least 24 
hours). Enter the following command: 


$ @SYSSUPDATE:AUTOGEN SAVPARAMS TESTFILES 


This command is for test purposes and does not result in the 
modification of SYSGEN parameters or changes to the page and 
swap files. Again, AUTOGEN warns you if the FEEDBACK data just 
produced is invalid. 


3 If you follow steps 1 or 2 and your current FEEDBACK data is valid, 
AUTOGEN uses your current FEEDBACK generated parameters 
during the upgrade. Your current FEEDBACK generated parameters 
will not be lost during the upgrade. 
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All of the following conditions must be met for the upgrade procedure to 
continue. Make sure: 


SYSUAE.DAT is in SYS$SYSTEM 
PAGEFILE.SYS is in SYS$SPECIFIC:[SYSEXE] 
There are enough free blocks on the system disk 
Volume shadowing is disabled on the system disk 
STARTUP_P1 is set to MIN 

DECnet is shut down 


The queue manager is not running 


To upgrade a standalone system, go to Chapter 7. 


To upgrade a VAXcluster environment, go to Chapter 6. 
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6 Upgrading a VAXcluster Environment 


This chapter describes how to upgrade a VAXcluster environment. Before 
you upgrade a VAXcluster environment, you must read the overview of the 
upgrade procedure described in Chapter 4. Refer to the VMS VAXcluster 
Manual for more detailed information on VAXcluster environments. 

You also must complete the entire pre-upgrade procedure described in 
Chapter 5. 


There are two types of cluster upgrades: concurrent and rolling. The type 
of upgrade you use depends on whether or not you want to maintain the 
availability of the cluster: 


¢ Concurrent upgrade—During a concurrent upgrade, you must shut 
down the entire cluster and upgrade each system disk. No one can use 
the cluster until you upgrade each system disk, and reboot each VAX 
computer. To perform a concurrent upgrade, see Section 6.1. 


¢ Rolling upgrade—During a rolling upgrade, you can keep some of the 
VAX computers in the cluster running while you upgrade others. The 
cluster runs temporarily with different versions of the VMS operating 
system. To perform a rolling upgrade, see Section 6.2. 


6.1 Performing a Concurrent Upgrade 


You perform a concurrent upgrade by shutting down the entire cluster, 
upgrading each system disk, and rebooting each VAX computer in the 
cluster. When the cluster reboots, each VAX computer will be running the 
upgraded version of the VMS operating system. No one can use the cluster 
until you upgrade each system disk and reboot each VAX computer. 


To perform a concurrent upgrade, use the following procedure: 


1 Shut down the entire cluster by logging into SYSTEM on each node 
locally, entering the following command, and choosing the CLUSTER_ 
SHUTDOWN option: 


§ @SYSSSYSTEM: SHUTDOWN 
2 If you have only one system disk for your cluster, go to step 3. 
If you have more than one system disk, select one to upgrade. 


3 Perform a conversational boot of a single VAX computer from the 
system disk you will be upgrading. For more information about the 
conversational boot procedure, refer to the VMS installation and 
operations guide for your VAX computer. 
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At the SYSBOOT> prompt, use the SHOW VOTES and SHOW 
EXPECTED_VOTES command to display the current values of the 
parameters. Write these values down because you will need to restore 
them later. Set the VOTES and EXPECTED VOTES values to 1, by 
entering the following commands. Press RETURN after each one: 


SYSBOOT> USE CURRENT 
SYSBOOT> SET VOTES 1 
SYSBOOT> SET EXPECTED VOTES 1 
SYSBOOT> CONTINUE 


4 Upgrade the system disk, using the procedure in Chapter 7. 
5 Ifyou have only one system disk, go to step 6. 


If you have more than one system disk, shut down the system that you 
just upgraded. Then repeat steps 3 and 4 to upgrade each system disk 
in the cluster. When you finish upgrading each system disk, go to 
step 6. 


6 Reboot each computer in the VAXcluster environment. 


7 Then complete the post-upgrade procedure, described in Chapter 8. 





6.2 Rolling Upgrade Overview 


During a rolling upgrade, you upgrade each system disk individually, 
allowing old and new versions of the VMS operating system to run 
together temporarily in the same cluster. Clusters running two versions 
of the VMS operating system are called mixed-version clusters. Because 
rolling upgrades allow mixed-version clusters, you maintain availability of 
the systems that you are not upgrading. 


CAUTION: To perform a Version 5.2 rolling upgrade, the other nodes in the 
cluster must be running at least Version 5.1 of the VMS operating 
system. 


Digital recommends that all VAX computers in a ciuster run the \ 
same version of the VMS operating system. Mixed-version clusters 
are supported only for the purpose of upgrading the entire cluster 


incrementally. 


A rolling upgrade does not apply when all systems boot from a single 
system disk. When all systems boot from a single system disk, perform a 
concurrent upgrade using the procedure described in Section 6.1. 


6.2.1. Performing a Rolling Upgrade 
To perform a rolling upgrade, use the following procedure: 


1 Check the votes and make adjustments to maintain the proper quorum 
so that the cluster can continue to operate throughout the upgrade. 
(The VMS VAXcluster Manual describes this procedure in detail.) 


2 Select a system disk to upgrade. 
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If proper quorum is not maintained at any time during the upgrade 
procedure, the shutdown procedure will hang the cluster. If the cluster 
hangs during a shutdown, enter the following commands and press 
RETURN after each one: 

$ 

>>> H 

>>> D/I 14 C 

>>> C 

IPC> Q 

IPC> 


Shut down all VAX computers booting from the system disk that you 
are upgrading. Do not shut down the computer that you will use to 
apply the upgrade. 


VAX computers that do not boot from the system disk that you 
are upgrading remain available to users. 


a. Log into the SYSTEM account on the VAX computer you are 
shutting down. 


b. Enter the following command and press RETURN: 
S$ @SYSSSYSTEM: SHUTDOWN.COM 


c. On one of the remaining VAX computers in the cluster, enter the 
following command and press RETURN: 


$ SET CLUSTER/EXPECTED VOTES 


d. Repeat steps a through c for each VAX computer requiring a 
shutdown. 


This procedure lets one VAX computer continue running from the 
system disk (assuming computers running from different system disks 
supply enough votes to sustain cluster quorum). 


Upgrade the system disk, using the procedure in Chapter 7. 


Reboot each VAX computer that boots from the system disk you have 
just upgraded. 


Repeat steps 2 through 6 for each system disk you are upgrading. 
Then complete the post-upgrade procedure, described in Chapter 8. 
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7 Standalone Upgrade 


This chapter explains the upgrade procedure for a single VMS system. 
Before you begin the upgrade procedure, you must read the overview of 
the upgrade procedure described in Chapter 4. You also must complete the 
entire pre-upgrade procedure described in Chapter 5. 


The upgrade procedure is divided into six phases. You must complete each 
phase of the upgrade procedure. On most VAX computers the upgrade 
procedure continues automatically from phase to phase. Read the screen 
displays carefully and, if you need to reboot your VAX computer manually, 
refer to the VMS installation and operations guide for your VAX computer. 


CAUTION: The MicroVAX I, VAXstation I, and VAX 11/725 computers are no 
longer supported. The RK07, RLO2, RC25, RD51, and RD52 drives 
are no longer supported as system disks. 


7.1 Beginning the Upgrade Procedure 


This section describes how to get your disk and tape drives ready and 
how to start the upgrade procedure using VMSINSTAL. You can type a 
question mark (?) for help at any time while running VMSINSTAL. 


1 Put the distribution media in the drive. If your VMS distribution kit 
contains several pieces of media, put the first volume in the drive. 


2 To start VMSINSTAL, use the following procedure: 
a. Login to the SYSTEM account. 
b. Enter the following commands and press RETURN after each one: 


S$ SET DEFAULT SYSSUPDATE 
S @VMSINSTAL 


VMSINSTAL displays messages similar to the following: 
VAX/VMS Software Product Installation Procedure V5.1 


It is 19-APR-1990 at 15:00.00.00 
Enter a question mark (?) at any time for help. 


3 The procedure displays the following message: 
* Are you satisfied with the backup of your system disk [YES]? 


If you have made a backup of the system disk, press RETURN and go 
to step 4. 


If you have not made a backup of the system disk, do the following: 


a. Type N (for NO) and press RETURN. VMSINSTAL ends and the 
dollar-sign prompt ($) is displayed. 


b. Back up the system disk as described in the VMS installation and 
operations guide for your VAX computer. 
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c. After you have made a backup of the system disk, start the 
upgrade procedure again from the beginning of Section 7.1. 


4 VMSINSTAL asks for the name of the drive that holds the distribution 


media: 
* Where will the distribution volumes be mounted: 


Enter the device name of the drive. For example, if you have a 
VAX 6360 computer that has a TK70 with a device name of MUC6, 
enter the following command and press RETURN: 


* Where will the distribution volumes be mounted: muc6 


If the drive is connected to an HSC, enter the HSC name and the 
device name of the drive separated by a dollar sign ($). For example, 
if the HSC name is MUTT, and the device name is DJA2, enter the 
following and press RETURN: 


* Where will the distribution volumes be mounted: muTTsDJA2 


If VMSINSTAL displays an error message, make sure the drive is 
connected and set up properly. Enter the name again. If VMSINSTAL 
displays another error message, verify the device name using the 
following procedure: 


a. Press CTRL/Y. 


b. Enter the SHOW DEVICE command to make sure you have the 
correct device name. 


c. Start the upgrade procedure again from the beginning of 
Section 7.1. 


When VMSINSTAL displays the following message, type VMS052 and 
press RETURN. For example: 


* Products: yMs052 
When the procedure displays the following message, press RETURN: 


* Options: 


7 VMSINSTAL displays a message similar to the following: 


Please mount the first volume of the set on _DJA2. 


When the procedure displays the following message, type Y (for YES) 
and press RETURN: 


* Are you ready? y 


After several minutes, the procedure displays messages similar to the 
following: 


SMOUNT-I-MOUNTED, VMSO052 mounted on _DJA2: 


The following products will be processed: 


VMS V5.2 
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After several more minutes, the procedure displays messages similar 
to the following: 


Beginning installation of VMS 5.2 at 15:05 
SVMSINSTAL-I-RESTORE, Restoring product saveset A... 
VAX/VMS V5.2 Upgrade Procedure 


' Model: VAX-6240 
System device: RA82 - MISSINGSDUAIL: 
Free blocks: 752667 


The upgrade procedures display several messages that provide you 
with the following information: 


¢ What VMSINSTAL is doing. 


¢ Notes, suggestions, and restrictions about various parts of the 
upgrade. 


e Status of the upgrade. 


Read these messages carefully to decide whether or not you need to 
interrupt the upgrade procedure. 


An interruption is allowed before Phase 1. The procedure displays the 
following message: 


* Do you want to continue? (Y/N): 

To continue the upgrade, type Y (for YES) and press RETURN. 
To interrupt the upgrade, use the following procedure: 

a. Type N (for NO) and press RETURN. 

b. Press CTRL/Z. 


The procedure displays the current date and time. If the date and 
time are correct, type Y (for YES). If they are incorrect, type N (for 
NO). Enter the correct date and time using the 24-hour clock format 
and press RETURN. For example: 


PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH:MM) 19-APR-1990 15:10 





7.2 Upgrade Phase 1 


This section describes Phase 1 of the upgrade. During Phase 1 you provide 
passwords for system accounts and select VMS and VMS DECwindows 
options. During Phase 1 the procedure restores the VMS Version 5.2 files 
in the VMS required save set. At the end of Phase 1, the procedure shuts 
down and reboots your VAX computer. 


SyStemt 
syotest + 


Citld 3 


At the beginning of Phase 1, the procedure displays a message similar to 
the following: 


Upgrade Phase 1 19-APR-1990 15:11:17.05 


To ensure system security, the upgrade procedure requires you to 
change the passwords for the SYSTEM, SYSTEST, and FIELD 
accounts before continuing. Passwords must be at least eight 
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characters in length; they do not appear on the display. Press 
RETURN after you enter each one. After you enter the passwords, 
the procedure checks each one to make sure it meets the requirements 
for a good password. For example: 

To help provide a more secure system, you are asked to enter passwords 


for key system accounts. Passwords must be a minimum of 8 characters 
in length. You may enter new or existing passwords. 


Enter passwords for the following accounts: 
SYSTEM, SYSTEST, FIELD 


* Enter password for SYSTEM: 
x Re-enter for verification: 


%UAF-I-MDFYMSG, user record(s) updated 
SVMS-I-PWD OKAY, account password for SYSTEM verified 


* Enter Password for SYSTEST 
* Re-enter for verification: 


SUAF-I-MDFYMSG, user record(s) updated 
*6VMS-I-PWD OKAY, account password for SYSTEST verified 


The SYSTEST CLIG account will be disabled. You must re-enable 
it before running UETP but do not assign a password.) 


Enter new password for account FIELD: 
Re-enter the password for account FIELD for verification: 


SUAF-I-MDFYMSG, user record(s) updated 
$VMS~I-PWD OKAY, account password for FIELD verified 


If you enter a password incorrectly or if the password is too easy to 
guess, the procedure displays error messages similar to the following: 


SVMS-W-PWD_INVALID, account password for FIELD is invalid 
-VMS-I-PWD_WEAK, password is too easy to guess 


Because of the preceding error, you must take action to secure this account. 
You must either disable this account, change its password, or do both. 


When the procedure asks if you want to disable the account, type N 
(for NO) and press RETURN. When the procedure asks if you want 
to enter a new password, type Y (for YES) and press RETURN. Then 
enter a new password. For example: 

Do va want to disable the account (Y/N)? N 

Do you want to change the account password (Y/N)? Y 

You must now select a new primary password for the FIELD account. The 


password you select must be at least 8 characters in length and may not be the 
same as the name of the account. 


New password: 
Verification: 


%SUAF-I-MDFMSG, user record(s) updated 
SVMS-I~PWD-SET, primary password for account FIELD set 


The procedure does the following: 
e Stops OPCOM 
e Stops the error formatter (ERRFMT) 


If your VAX computer does not have console media, go to the next 
step. If your VAX computer has console media, the procedure might 
ask you to insert the console media in the drive. Use the backup copy 
of the console media. Make sure the console media is write-enabled. 
Insert the console media in the drive and do not remove it from the 
drive until the upgrade has been completed. The procedure displays a 
message similar to the following: 
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* Do you want to boot from the [console media]? 


If you are booting directly from a local system disk, type N (for NO) 
and press RETURN. If you are using a CI750, type Y (for YES) and 
press RETURN. 


If you typed Y (for YES), the procedure displays a series of messages 
about booting from console media. Follow the instructions displayed 
on the screen. 


The procedure displays the following message: 
* Do you want to continue? (Y/N) 
To interrupt the upgrade, type N (for NO) and press RETURN. 


To continue the upgrade, type Y (for YES) and press RETURN. For 
some computers, the procedure temporarily modifies DEFBOO.CMD 
(or DEFBOO.COM if you have a VAX 8600 computer) to boot from 
the [SYSF] directory. During Phase 4 of the upgrade, the procedure 
restores the DEFBOO.CMD (or DEFBOO.COM if you have a VAX 8600 
computer) file that is set up to boot from the current system disk and 
system root. 


The procedure does the following: 


e Cleans up the system disk by purging all accounting data files, 
operator logs, and the directory SYSERR. The procedure also 
deletes all JNL files in the root directory and its subdirectories. 


e Builds the directory tree [SYSF] and deletes the old operating 
system files that will not be needed if the system needs to be. 
rebooted during Phase 1 of the upgrade. 


The procedure displays a series of messages about VMS and VMS 
DECwindows files. To select the VMS and VMS DECwindows options 
you want to install, follow the instructions displayed on the screen. 
For example: 


SMOUNT-I-MOUNTED, VMS052 mounted on _MUAO: 


The full VMS kit will be installed on this system disk. 
The following components (with approximate sizes) will be provided: 


VMS library - 26500 blocks 
VMS optional - 14500 blocks 


You can provide DECwindows support now, or you can use the 
DECWSTAILOR utility to provide or remove DECwindows support 
after the installation. 


NOTE: Some media, TK50s in particular, can be very slow when 
tailoring on files. You might want to provide DECwindows 
options now and tailor off unwanted files later. 


*Do you want to provide optional DECwindows support? (Y/N) 


If you do not want to install VMS DECwindows software, type N (for 
NO) and go to step 7. 


If you do want to install VMS DECwindows software, you are asked 
to choose the options that you want to install. Consider the following 
about the optional VMS and VMS DECwindows files: 


e Applications files—VMS._DECwindows provides a variety of 
applications; including the following: Bookreader, Calculator, 
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Calendar, Cardfiler, Clock, DDIF Document Viewer, EVE Text 


Editor, FileView, Mail, Notepad Text Editor, Paint Graphics Editor, 


PostScript Previewer, and DECterm, the Session Manager, and the 
Icon Box. If you are installing VMS DECwindows software on a 
VAXstation, you need these files. 


Device support files—If you are installing VMS DECwindows 
software on a VAXstation or in a cluster that includes VAXstations, 
you need these files. Otherwise you do not need them. 


100 dots-per-inch (100DPI) video font files—All VMS DECwindows 
applications run with 75 dots per inch (dpi) fonts. Certain 
applications take advantage of 100 dpi fonts. 


Programming support files—The VMS DECwindows programming 
support files are needed only to develop applications and are 

not required to run VMS DECwindows applications. Support 
files are supplied for the following VAX programming languages: 
Ada, BASIC, BLISS, C, FORTRAN, MACRO, Pascal, and PL/1. 
In addition, support files are supplied for programming in the 

C language using conventions and standards developed at the 
Massachusetts Institute of Technology. 


The optional VMS DECwindows files are listed in Appendix D. 
Use DECW$TAILOR to remove the VMS DECwindows files you do 
not need. For more information on DECW$TAILOR, see the VMS 
installation and operations guide for your VAX computer. 


The procedure will restore the options you choose during Phase 2. 


Upgrade Phase 2 


The procedure restores the VMS required save set and purges the 
page, swap, dump, and authorization files. 


After several minutes, the upgrade procedure indicates that it will 
shut down to reboot the partially installed VMS Version 5.2 system. 


When the shutdown is complete, if your system boots from console 
media, it should automatically reboot from the [SYSF] directory. if 
your system does not boot from console media, halt the system and 
boot from the [SYSF] directory as described in Appendix A. 


When the system reboots, it displays the VMS banner, and the 
following error message which you can ignore: 


%SYSINIT-W-invalid dump header version - error log buffers not saved 
VAX/VMS Version BC52-xxx Major version id = 1 Minor version id = 0 





This section describes Phase 2 of the upgrade. During Phase 2, the 


procedure installs the VMS library and optional save sets (if you elected to 
install them), and VMS DECwindows software (if you elected to install it). 
At the beginning of Phase 2, the procedure displays a message similar to 
the following: 


Continuing with VAX/VMS V5.2 Upgrade Procedure. 
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The procedure also displays messages about licenses which you can ignore. 
During Phase 2, the upgrade procedure does the following: 


1 Phase 2 restores the rest of the optional VMS files. If your VMS 
distribution kit contains more than one piece of media, the procedure 


asks you to replace the volume in the drive with the next one in the 
kit. 


2 Ifyou are not installing VMS DECwindows software, go to Section 7.4. 


If you are installing VMS DECwindows software, the procedure 
displays the following message: 


You may now remove the VMS distribution kit from ddcu:. 
Put the DECwindows distribution kit in the drive. 


* Enter name of drive holding the DECwindows distribution media: 


Note: If you have either an RLO2 or RKO7 kit, VMS DECwindows is on 
magnetic tape. If you have an RX33 kit, VMS DECwindows is 
on a tape cartridge. Check the labels and place the appropriate 
piece of media on the appropriate drive. 


Remove the VMS distribution media from the drive, and insert the 
VMS DECwindows distribution media. Then enter the device name of 
the drive. The procedure displays the following message: 


* Is the DECwindows media ready to be mounted? [N] 
Type Y (for YES) and press RETURN. 
3 The procedure displays messages similar to the following: 


SMOUNT-I-MOUNTED, DECW52 mounted on _MUAO: 


Restoring DECwindows applications saveset... 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows device support saveset... 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows 750DPI fonts saveset... 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows 100DPI fonts saveset... 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows programming support saveset... 
SBACKUP-I-STARTVERIFY, starting verification pass 


You may now remove the DECwindows distribution kit from MUAO: 


4 Remove the VMS DECwindows distribution media from the drive. 





7.4 + Upgrade Phase 3 


At the beginning of Phase 3, the procedure displays a message similar to 
the following: 


Continuing with VAX/VMS V5.2, Upgrade Procedure 
Upgrade Phase 3 19-APR~1990 16:45:18.35 
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During Phase 3, the upgrade procedure does the following: 


Merges the VMS-distributed files that are commonly edited by system 
managers with new VMS files. 


Merges all the miscellaneous user files in the old system directories 
into a new set of system directories, temporarily called SYSF.SYSEXE, 
SYSE.SYSMGR, SYSE.SYSLIB, and so on. 


Removes the directory entries for page, swap, dump, and authorization 
files from the old directory tree. 


Deletes all the remaining accounting data files, operator logs, and all 
files in the SYSERR directory. 


Merges the old and new versions of the following files: HELP, 
DCLTABLES, IMAGELIB.OLB, and STARLET.OLB. 


Moves all remaining files from old directory tree (VMS$COMMON] to 
the new directory tree. 


Deletes old directory tree [(VMS$COMMON]. 


May display LIBRAR-E-DUPGLOBAL errors and file-not-found 
messages which you can ignore. 





7.9 Upgrade Phase 4 


At the beginning of Phase 4, the procedure displays a message similar to 
the following: 


Continuing with VAX/VMS V5.2 Upgrade Procedure. 


Upgrade Phase 4 19-APR-1990 17:14:34.12 


During Phase 4, the upgrade procedure does the following: 


1 


Corrects back pointers for system directories. 


Shuts down the system. 


Reboots the system from the original system root (usually SYSO). 


If you are upgrading a VAX 8530, 8550, 8810, or 8820-N computer, do 
the following: 


a. Restore the original copies of DEFBOO and dddGEN to boot from 
the original root directory. 


b. In the pre-upgrade procedure (Chapter 5), you made copies of 
the boot command procedures, DEFBOO.SAV and dddGEN.SAV. 
To restore the original names to these files, enter the following 
commands and press RETURN after each one: 


2>> EXIT 
S RENAME DEFBOO.SAV DEFBOO.COM 
S RENAME dddGEN.SAV dddGEN.COM 


4 After the system boots, the procedure displays the following message: 


VAX/VMS Version BC52-xxx Major version id = 1 Minor version id = 0 
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7.6 Upgrade Phase 5 


At the beginning of Phase 5, the procedure displays a message similar to 
the following: 


Continuing with VAX/VMS V5.2 Upgrade Procedure. 
Upgrade Phase 5 19-APR-1990 17:45:24.03 
During Phase 5, the upgrade procedure does the following: 
e Displays messages about licenses which you can ignore. 
¢ Deletes the temporary [SYSF] directory tree. 
e Cleans up files used only during the upgrade procedure. 


e Converts all VAXVMSSYS.PAR parameter files found in system roots 
to Version 5.2 format. 


e Checks the security of DECnet objects and images. 


e Displays messages listing tasks that you might want to perform after 
the upgrade procedure is completed. Chapter 8 explains these tasks. 





7.7 Upgrade Phase 6 


At the beginning of Phase 6, the procedure displays a message similar to 
the following: 


Continuing with VAX/VMS V5.2 Upgrade Procedure. 
Upgrade Phase 6 19-APR-1990 18:09:38.14 


During Phase 6, the upgrade procedure configures all devices on the 
system. It also applies the mandatory update, which is provided on 

separate media. Use the following procedure to apply the mandatory 
update: 


1 The procedure asks for the name of the drive that holds the 
distribution media: 


* Where will the distribution volumes be mounted: 


Enter the device name of the drive. For example, if you have a 
VAX 8200 computer with a device name of DJA1, enter the following: 


* Where will the distribution volumes be mounted: DJAIL1 


The procedure asks you to mount the distribution media. Make sure 
the media is write-protected and place it in the drive. 


* Please mount the first volume of the set on ddcu:. 


2 The procedure asks if you are ready. Type Y (for YES) and press 
RETURN. For example: 


* Are you ready? yY 
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The procedure displays the following series of messages: 


SMOUNT-I-MOUNTED, VMSMUP mounted on _DJAIL: 
The following products will be processed: 
VMSMUP V5.2 
Beginning installation of VMSMUP V5.2 at 15:00 
SVMSINSTAL-I-RESTORE, Restoring product saveset A... 


Installing VMS V52 mandatory update 


If the upgrade procedure cannot determine the system communications 
services (SCS) node name for your system, it prompts you as follows: 


Unable to determine the SCS node name to be used for the VMS 
license. If the machine will be a member of a cluster, 
please enter the SCS node name at the prompt. If it will not 
be a cluster member, press the RETURN key. 


SCS Node Name: 


Follow the instructions in the display and either press the RETURN 
key or enter the SCS node name. 


If there is more than one piece of media containing the mandatory 
update, you will be asked to switch them at some point during the 
procedure. Read the screen displays. When the procedure finishes, it 
displays a message similar to the following: 


Installation of VMSMUP V5.2 completed at 15:00 
VMSINSTAL procedure done at 15:02 


After applying the mandatory update, AUTOGEN runs and displays 
the following series of messages: 


Running AUTOGEN to compute the new SYSGEN parameters. 


An attempt may be made to re-size the pagefile or swapfile. If 
there is insufficient room on the disk, the recommended size is 
displaved with a message that the file should be created or 
extended manually by the system manager later on. 


Running AUTOGEN - Please wait. 


If the procedure displays a message similar to the following, see the 
Guide to Maintaining a VMS System for information on setting the 
sizes of the PAGE, SWAP, and DUMP files. 


RKKKEKKKKKEKKKKKEKKKE 


SAUTOGEN-W-DSKSPC, The disk on which DISKSVAXVMSRL5: [SYSO.SYSEXE] PAGEFILE.SYS 
resides would be over 95% full if it were modified to hold 20000 
blocks. 


KREKRKKKKKKKKKEKKEKK 
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After AUTOGEN finishes, the procedure displays a sequence of 
shutdown messages that begins like this: 


The system is shutting down to allow the system to boot with the generated 
site-specific parameters and installed images. 


The system will automatically reboot after the shutdown and the 
upgrade will be complete. 


SHUTDOWN -- Perform an Orderly System Shutdown 


After AUTOGEN is complete, the system shuts down and may 
automatically reboot. If the system does not automatically reboot, 
reboot it manually. 


During the reboot, the VMS DECwindows software waits for DECnet 
to start up. After several minutes the VMS DECwindows software 
times out and displays the following message: 


SDECW-F-NODECNET, DECwindows cannot start without DECnet 


Ignore this message. To start the VMS DECwindows software, see 
Chapter 8. 


If you are upgrading a standalone system, skip this step. If you are 
upgrading a VAXcluster system, the system might hang when you try 
to reboot the upgraded system disk. This is because the total cluster 
votes is less than the cluster quorum value. To remedy this situation, 
boot voting nodes that run from the system disk you just upgraded. 


After the system reboots, the procedure displays the following message: 


KKRERKKKKEKKEKKKKKREKKEKEKRREKEKEKKEKKEEKKEREKEKREKKKKKEKRKEKEKRRKEKEKRKEKKKKKEKRKKKKEKKEKKKKKKREEKE 


VAX/VMS V5.2 
You have SUCCESSFULLY installed the VMS operating system. 


The system is now executing the STARTUP procedure. Please 
await the completion of STARTUP before logging into the 
system (approximately three minutes). 


KRKKEKKEKKKKKKKKKEKKKKKEKKKEKKAKEKKKKKKK KKK KKKEKKKRKK KK EKER KKEKKEKKKKEKEKKEK KKK RR KRKKKEK 


Finally, the procedure displays informational messages as well as 
accounting information. For example: 
Startup processing continuing... 


$SET-I-INTSET, login interactive limit=64, current interactive value = 0 
19-APR-1990 13:00:00.00 


SYSTEM job terminated at 19-APR-1990 13:00:00.00 
Accounting information: 

Buffered I/O count: 133 Peak working set size: 401 
Direct I/O count: 12 Peak virtual size: Z379 
Page faults: 325 Mounted volumes: 0 
Charged CPU time 0 00:00:55.23 Elapsed time 0 00:01:31.24 


At this point the VMS operating system is running. 
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11 Press RETURN. The system asks for the user name and password. 
Log in to the SYSTEM account so that you can perform certain post- 
installation procedures. 


Welcome to VAX/VMS V5.2 
USERNAME: SYSTEM 
PASSWORD: 


* WeLebme BS VAX/VMS V5.2 
If you forget the password, follow the instructions for performing an 
emergency startup in Guide to Setting Up a VMS System. 


There are several things you must do to your newly-upgraded system disk. 
Chapter 8 explains these tasks. 


© 
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After you have upgraded the VMS operating system, you need to perform 
several important tasks before you can use the system. This chapter tells 
you what the tasks are, whether they are optional or required, and the 
order in which you perform them. The following list summarizes the tasks 
described in this chapter: 


1 Replacing SYSUAF.DAT 

2 Examining your command procedures 
3 Changing MODPARAMS.DAT 
4 


Running NETCONFIG_UPDATE.COM and sharing the DECnet 
permanent database 


5 Updating your console media 

6 Decompressing the system libraries 

7 Running UETP 

8 Removing unwanted files and checking the sizes of system files 
9 Starting DECwindows — 

10 Building standalone BACKUP 

11 Backing up the system disk 

12 Running AUTOGEN 


8.1 Replacing SYSUAF.DAT 


Note: 


If you permanently store SYSUAF.DAT on the system disk, skip this 
section and go to Section 8.2. 


If you do not permanently store SYSUAF.DAT on the system disk, 

you copied it to the system disk before you did the upgrade. The 
upgrade procedure updates SYSUAF.DAT. Copy this updated version 

of SYSUAF.DAT from the system disk to the directory where you usually 
keep it. | 


If you did a rolling upgrade, the shared version of SYSUAF.DAT 
was not updated. 
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8.2 , Examining YourCommand Procedures 


8.3 


8.4 


8.4.1 


/ 


The upgrade procedure places the latest versions of the following command 
procedures on your system disk: 


[SYSMGR] LTLOAD .COM 
[SYSMGR] RTTLOAD . COM 
[SYSMGR] STARTNET.COM 
[SYSMGR] SYLOGIN.COM 
[SYSMGR] SYSTARTUP_V5.COM 
[SYSMGR] SYCONFIG.COM 
[SYSMGR] SYSHUTDWN .COM 
[SYSMGR] SYPAGSWPFILES.COM 
[SYSMGR] SYLOGICALS.COM 


Examine these files before you purge them. Your original versions may 
have site-specific changes you want to save. Edit the new versions of the 
files as necessary. 


Changing MODPARAMS.DAT 


Review the file SYS$SYSTEM:MODPARAMS.DAT. The upgrade procedure 
created a new version of this file. Modify the new file, if necessary, for 
your system. 


If you are upgrading a VAXcluster, you must update the 
MODPARAMS.DAT file for each VAX computer that boots from the system 
disk. Make sure the EXPECTED_VOTKES value is correct. The value is 
the sum of all VOTES in the cluster. For example, if there are five VAX 
computers in the cluster, and each has one VOTE, the value is five. As you 
reboot each VAX computer, AUTOGEN runs automatically. The cluster 
forms when enough computers have been booted to attain cluster quorum. 





Running DECnet 


If you are not running DECnet, skip this section and go to Section 8.5. 


If you are running DECnet, follow the instructions in Section 8.4.1 and 
Section 8.4.2. 


Running NETCONFIG_UPDATE.COM 


Vv 
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NETCONFIG_UPDATE.COM is a new command procedure that 
implements several security measures that pertain to default access 

to your system. When you run NETCONFIG_UPDATE.COM your 
configuration database does not change, except for the changes you may 
make to the default DECNET account or the accounts you may create for 


specific objects. 


NETCONFIG_UPDATE.COM generates passwords for each account 
that you decide to keep in your configuration database. For example, 
if you currently have a default DECNET account and decide to keep 
it, NETCONFIG_UPDATE.COM generates a new password for it and 
replaces the existing password with the new one. 
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Enter the following command: 


$ @SYSSUPDATE:NETCONFIG UPDATE 


The procedure displays information about default access to various 
network objects and asks you some questions. Use the following 
information to determine how best to answer the questions. 


DECNET—The default DECnet account, named DECNET, allows all 
network objects general access to the system. It is only appropriate 
for networks with very low security requirements. For networks with 
greater security requirements, Digital recommends separate default 
accounts for specific network objects. 


TASK—The TASK object, by means of the default DECnet account 
(DECNET), allows user-written command procedures—including those 
which might be used in attempted break-ins—to be executed on your 
system. You can disable default access to the TASK object and still 
allow remote user-written command procedures to run on your system 
by using access control strings or proxy access. 


MAIL—MAIL is an image that provides personal mail services for 
VMS systems. To receive MAIL, you must create a default account for 
the MAIL object. An account named MAIL$SERVER will be created 
on your system if you reply YES to this query. 


FAL—FAL (File Access Listener) is the remote file access facility. FAL 
is an image that receives and processes remote file access requests 
for files at the local node. A default account for FAL allows network 
access, by any remote user, to any files marked world-accessible. It 
also allows any remote user to create files in any directory with world 
WRITE access. An account named FAL$SERVER will be created on 
your system if you reply YES to this query. 


PHONE—PHONE is an image that allows online conversations with 
users on remote VMS systems. A default account for this object lets 
anyone in the network get a list of users currently logged in to the 
local system. A user can then attempt a login using the list of user 
names. An account named PHONE$SERVER will be created on your 
system if you reply YES to this query. 


NML—NML is the Network Management Listener. A default account 
for this object lets Remote users issue NCP TELL commands to gather 
and report network information from your volatile DECnet databases. 
An account named NML$SERVER will be created on your system if 
you reply YES to this query. 


VPM—VPM is the VMS Performance Monitor. To use the cluster 
monitoring features of the Monitor Utility (MONITOR), you must 
create a default account. An account named VPM$SERVER will be 
created on your system if you reply YES to this query. 


8-3 


After You Do an Upgrade 
8.4 Running DECnet 


¢ MIRROR—MIRROR is an image that is used for most types of 
loopback tests, including those run during the DECnet phase of the 
User Environment Test Program (UETP). To run most loopback tests, 
you must create a default account for the MIRROR object. An account 
named MIRRO$SERVER will be created on your system if you reply 
YES to this query. 


For a description of the network configuration procedure, 
NETCONFIG.COM, refer to the Guide to DECnet-VAX Networking. For 
information on the security enhancements to NETCONFIG.COM, refer to 
the VMS Version 5.2 New Features Manual. 


8.4.2 Sharing the DECnet Permanent Database 


You can share the components of the DECnet-VAX permanent database 
among some or all of the VAX computers in a VAXcluster. The 
permanent database consists of several separate files. By default, 

these files are located in SYS$SPECIFIC:[SYSEXE]. For example, after 
initializing a VAX computer, the permanent object database is located 

in SYS$SPECIFIC:[SYSEXEJNETOBJECT.DAT. If the object database 

is identical on some computers in the cluster, these computers can be 
configured to share one copy of the file. The following commands establish 
a shared permanent object database: 


1 Copy the permanent object database from one VAX computer in the 
cluster to the shared system disk. For example: 


$ COPY SYSSSPECIFIC: [SYSEXE]NETOBJECT.DAT - 
$ SYSSCOMMON: [SYSEXE]NETOBJECT.DAT 


2 For each VAX computer in the cluster that should share the database, 
delete the permanent object database from the private system disk. 
For example: 


$ DELETE SYSSSPECIFIC: [SYSEXE]NETOBJECT. DAT; * 


The remote node database (NETNODE_REMOTE.DAT) is another 
permanent database component that can be shared. To make this 
component shareable, use the following procedure: 


1 Copy NETNODE_REMOTE.DAT from the VAX computer to the shared 
system disk. For example: 


$ COPY SYSSSPECIFIC: [SYSEXE]NETNODE REMOTE.DAT - 
$ SYSSCOMMON: [SYSEXE]NETNODE REMOTE. DAT 


2 Delete the copy of this file on each VAX computer in the cluster that 
will share this file from SYS$SPECIFIC:[SYSEXE]. For example: 


$ DELETE SYSSSPECIFIC: [SYSEXE] NETNODE REMOTE. DAT; * 


3 If you want to move the information from the shared permanent 
database into your volatile database, enter the following commands 
and press RETURN after each one: 


S RUN SYSSSYSTEM:NCP 
NCP> SET KNOWN NODES ALL 
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For additional information on the permanent database, refer to the VMS 
Networking Manual. 





8.5 Updating Your Console Media 


You must copy the Version 5.2 VMB.EXE onto your system’s console media. 
Section 8.5.1 describes the procedure to use if you have a VAX 8530, 8550, 
8700, 8800, 8810, or 8820-N. 


Section 8.5.2 describes the procedure to use if you have one of the following 
VAX computers: 


VAX—-11/730 

VAX—1/750 

VAX-—11/780, 785 

VAX 8200, 8250, 8300, 8350 
VAX 8600, 8650 


8.5.1 VAX 8530, 8550, 8700, 8800, 8810, 8820-N 


If you have a VAX 8530, 8550, 8700, 8800, 8810, or 8820-N, follow the 
directions in this section. 


1 


3 


Place a blank RX50 diskette in one of the console diskette drives. The 
console refers to the upper (or left-hand) diskette drive as DZ1 while 
the VMS operating system refers to it as CSA1. The console refers 

to the lower (or right-hand) drive as DZ2 while the VMS operating 
system refers to it as CSA2. 


Make sure the diskette drives have been connected to the VMS 
operating system, as follows: 


$ SHOW DEVICE CSA 


Device Device Brror Volume 
Name Status Count Label 
CSAQ: (SYSTEM) Online 0 
CSAL: (SYSTEM) Online 0 
CSA2: (SYSTEM) Online 0 


If the drives are not connected, the following message is displayed: 
SSYSTEM-W-NOSUCHDEV, no such device available 


If this message is displayed, enter the following commands (you need 
CMKRNL privilege): 


S RUN SYSSSYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


To initialize the diskette, enter a command in the following format and 
press RETURN: 


S$ INITIALIZE/STRUCTURE=1 device-name: volume~-label 


Substitute CSA1 or CSA2 for device-name. Substitute a 1- to 
12-character name for volume-label. For example: 


S$ INITIALIZE/STRUCTURE=1 CSA1: SHOEHAIR 
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10 


11 


Enter the following commands to mount the diskette, create the 
required directories, and copy the new VMB.EXE to the diskette. 
Substitute CSA1 or CSA2 for device-name. 


$ MOUNT/OVERRIDE=ID device-name: 
S CREATE/DIRECTORY device-name: [TRANSFER] 
S$ COPY SYSSSYSTEM:VMB.EXE device-name: [TRANSFER] 


Once you have copied all the files, enter the following command to 
dismount the diskette. Substitute CSA1 or CSA2 for device-name. 


S$ DISMOUNT device-name: 


To enter console mode, press CTRL/P. To exit from the console program, 
enter the following command and press RETURN: 


>>> EXIT 


Open the diskette drive door, pause for a moment, and close it. The 
red indicator light should flash. 


To copy VMB.EXE from the diskette to the console fixed disk drive, 
enter the following command and press RETURN: 


S$ COPY DZu: [TRANSFER] VMB.EXE LBO: [CONSOLE] 
Substitute DZ1 or DZ2 for DZu. 


The fixed drive in the console is known by two names, DW2 and 
LBO. Most console files are stored using the name LBO. If the system 
displays a message that describes a protection violation on the output 
device, copy the files using the device name DW2. 


When you have finished copying the files, remove the diskette from the 
drive. 


Restart the console program by entering the following command and 
pressing RETURN: 


S$ RUN CONTROL 


Return to the VMS operating system by entering the following 
command and pressing RETURN: 


>>> SET TERM PROGRAM 


VAX 11/730, 750, 780, 785 and VAX 8200, 8250, 8300, 8350, 8600, 8650 


If you have one of the following VAX computers, follow the directions in 
this section: 


VAX—11/730 

VAX—1/750 

VAX-—11/780, 785 

VAX 8200, 8250, 8300, 8350 
VAX 8600, 8650 


This procedure does the following: 


Checks to see if you have enough space for the new VMB 
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e Copies the new VMB to the console media 


e Updates the BOOT58 file for the VAX 11/750, 8200, 8250, 8300 and 
8350 computers 


To update the console media, use the following procedure: 
1 Log into the SYSTEM account. 


2 Enter the following commands to check if there is enough space for 
the new VMB.EXE. You need 75 free blocks. If you are updating a 
VAX-11/730, use CSA2 for device-name; if you are updating one of the 
other VAX computers, use CSA1 for device-name. 


$ RUN SYSS$SYSTEM: SYSGEN 

SYSGEN> CONNECT CONSOLE 

SYSGEN> EXIT eehie 

$ EXCHANGE DIRECTORY device-name: VMB.EXE 


Directory of RT-11 volume TIGNESSCSAI1: 19-APR-1990 14:04 
VMB . EXE 64 19-Apr-1990 


Total of 1 file, 64 blocks. Free space 23 blocks, largest 16. 


If the size of the current VMB, plus the free space, does not equal at 
least 75 blocks, delete unneeded files on the console until you have 75 
blocks available. In the above example, 87 blocks are available, so files 
do not have to be deleted. 


3 Enter the following command and press RETURN: 
$ @SYSSUPDATE:UPDATE CONSOLE.COM 


4 Ifyou are updating a VAX 8600 or 8650 computer, the new VMB.EXE 
is copied onto the console. 


If you are updating one of the other VAX computers, the procedure 

uses the EXCHANGE procedure to copy the contents of the existing 
console, merge the new files onto the copy of the console, and create 
a new version of the console media. When the computer is ready to 
create the new version, it displays a message asking you to insert a 
scratch tape cassette or diskette. Take out the original and insert a 
new one. 





8.6 7 Decompressing the System Libraries 


Decompressing the system libraries gives the system faster access to 

the libraries. The decompressed libraries require approximately 7000 
additional blocks of disk space. To find out how much disk space you have, 
enter the following command and press RETURN: 


$ SHOW DEVICE SYSSSYSDEVICE 


If you have enough room on the disk, you can decompress the libraries. 
The decompression process takes approximately 30 minutes. Log into the 
SYSTEM account, enter the following command, and press RETURN: 


S @SYSSUPDATE : LIBDECOMP 
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8.7 Zi Testing the System with UETP 


You should run the User Environment Test Package (UETP) to verify that 
the upgrade was done correctly. For instructions on running UETP, see 
Chapter 9. 


8.8 / Removing Unwanted Files and Checking the Size of System Files 


8-8 


Note: 


Note: 


To increase free disk space, you can delete files that you do not need. 
Use the VMSTAILOR program to delete VMS files you do not need. Log 
into the SYSTEM account and enter the following command and press 
RETURN: 


S RUN SYSSUPDATE: VMSTAILOR 


The VMSTAILOR program asks you if you want to tailor files ON or OFF. 
Type OFF to remove unwanted files. 


The VMSTAILOR program lists each group of files and its size in blocks. 
Files are grouped according to their function. For example, all the files 
required for cluster support are in one group. A file group is made up of 
many small subgroups. You can eliminate an entire group of files, or you 
can eliminate one or more of its subgroups. 


Decide which file groups or subgroups you do not need to support your 
system. The VMSTAILOR program displays step-by-step instructions that \ 
are easy to follow. 


VMSTAILOR displays the names of the files it deletes. After it finishes, 
AUTOGEN runs automatically to make the adjustments that are 
necessary after system files are deleted. 


You can use VMSTAILOR at any time to delete or add groups of 
VMS files to the system disk. After adding files to the system disk, 
you should apply any updates that affect them. 


For example, suppose you do not need the VMS Version 5.2 MAIL \ 
utility and you run VMSTAILOR to remove those files. Later on, 

if you decide you want to use MAIL, you can run VMSTAILOR to 
return the MAIL files to the system disk. You then apply any VMS 
update that has occurred since Version 5.2 that affected the MAIL 
utility. 


To remove DECwindows files from the system disk, enter the following 
command and press RETURN: 


S RUN SYSSUPDATE:DECWSTAILOR 

The DECW$TAILOR program is similar to the VMSTAILOR program. 
To start VMS DECwindows, reboot the system conversationally 
and check the SYSGEN parameter WINDOW_SYSTEM. To start 


VMS DECwindows software, set this parameter to one. Also, if you 
tailor on or off device support files, the system will reboot. 
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When tailoring VMS DECwindows files, consider the following: 


e Applications files—VMS DECwindows provides a variety of 
applications; including the following: Bookreader, Calculator, 
Calendar, Cardfiler, Clock, DDIF Document Viewer, EVE Text Editor, 
FileView, Mail, Notepad Text Editor, Paint Graphics Editor, PostScript 
Previewer, DECterm, the Session Manager, and the Icon Box. If you 
are installing VMS DECwindows on a VAXstation, you need these files. 


e Device support files—If you are installing VMS DECwindows on a 
VAXstation or in a cluster that includes VAXstations, you need these 
files. Otherwise you do not need them. 


¢ 100 dots-per-inch (100DPI) video font files—All VMS DECwindows 
applications run with 75 dots per inch (dpi) fonts. Certain applications 
take advantage of 100 dpi fonts. 


e Programming support files—The VMS DECwindows programming 
support files are needed only to develop applications and are not 
required to run VMS DECwindows applications. Support files 
are supplied for the following VAX programming languages: Ada, 
BASIC, BLISS, C, FORTRAN, MACRO, Pascal, and PL/1. In addition, 
support files are supplied for programming in the C language using 
conventions and standards developed at the Massachusetts. Institute of 
Technology. 


You also can change the sizes of some files to increase free disk space. The 
size of the following files may have been changed to fit the system. Check 
these files to be sure that the sizes are appropriate. 


[SYSEXE] SYSDUMP . DMP 
[SYSEXE] PAGEFILE.SYS 
{SYSEXE] SWAPFILE.SYS 


To modify the size of these files, log into the SYSTEM account and enter 
the following command and press RETURN: 


$ @SYSSUPDATE:SWAPFILES 
You might want to purge the following VMS files: 


SYSSSYSTEM: SHUTDOWN .COM 
SYSSSYSTEM: STARTUP .COM 
SYSSLIBRARY: ENCRYPSHR.EXE 
SYSSLIBRARY: *RTL* . EXE 
SYSSLIBRARY: *SHR. EXE 
SYSSMANAGER: EDTINI.EDT 
SYSSMANAGER: DBLSTRTUP . COM 
SYSSMANAGER: LOGIN.COM 
SYSSMANAGER: SYSTARTUP_V5.COM 
SYSSMANAGER: TFFSSTARTUP .COM 
SYSSMANAGER: WELCOME. TXT 
SYSSMANAGER: *. TEMPLATE 
SYSSEXAMPLES : XADRIVER. MAR 
SYSSLIBRARY:CDDSHR.EXE | 
SYSSLIBRARY : EPCSSHR. EXE 
SYSSLIBRARY : EPCSFACILITY.TLB 
SYSSLIBRARY : EPCSMSG.EXE 
SYSSLIBRARY : UISSHR.EXE 
SYSSSTARTUP : VMSSLAYERED.DAT 
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8.10 
J 


8.11 
/ 


With VMS Version 5.2, DECwindows starts automatically after 
SYSTARTUP_V5.COM runs. If you upgraded from V5.1, V5.1-1, or V5.1-B, 
you need to edit SYSTARTUP_V5.COM and delete the following line: 


S @SYSSMANAGER : DECWSSTARTUP 


If you placed this command in a file other than SYSTARTUP_V5.COM, you 
can either delete the command from the file it is in or add the following 
command to SYSTARTUP_V5.COM: 


$ DEFINE DECWSIGNORE DECWINDOWS TRUE ! Delay DECwindows startup 


You should only add the above command to SYSTARTUP_V5.COM if your 
site-specific startup is going to start DECW$STARTUP at a later time. 
DECW$STARTUP should be started on all VAX computers, including 
those that are not using DECwindows. 


For more information on starting and customizing VMS DECwindows 
software, see Appendix B. 


Backing Up the System Disk 


Protect your work by making a backup copy of the upgraded system disk. 
Digital recommends that you also perform the following operations: 


e Make a standalone BACKUP kit | 
e¢ Back up the console media (if applicable) 


For complete information on these operations, see the VMS installation 
and operations guide for your VAX computer. 


Running AUTOGEN 
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Run AUTOGEN FEEDBACK and reboot the system after 24 hours of 
operation, and again two workdays later. AUTOGEN sets the values of 
system parameters and the sizes of the page and swap files according 
to the system’s workload. Digital recommends that you run AUTOGEN 
from SAVPARAMS thru TESTFILES on a weekly basis and examine 
one ro to determine the need for additional 
changes. 


Hardcoded values in MODPARAMS.DAT affect AUTOGEN’s calculations 
of the feedback parameters. For AUTOGEN FEEDBACK to properly 
calculate values, you should replace the hardcoded values in 
MODPARAMS.DAT with MIN_ values. 


For information on using AUTOGEN, see the Guide to Setting Up a VMS 
System. 


9 Running UETP 


The User Environment Test Package (UETP) is a VMS software package 
designed to test whether the VMS operating system is installed correctly. 
UETP puts the system through a series of tests that simulate a typical 
user environment, by making demands on the system that are similar to 
demands that might occur in everyday use. 


UETP is not a diagnostic program; it does not attempt to test every feature 
exhaustively. When UETP runs to completion without encountering 
nonrecoverable errors, the system being tested is ready for use. 


UETP exercises devices and functions that are common to all VMS 
systems, with the exception of optional features such as high-level 
language compilers. The system components tested include the following: 


¢ Most standard peripheral devices 
e The system’s multiuser capability 
e DECnet-VAX 


e Clusterwide file access and locks 


9.1 Summary of UETP Operating Instructions 


This section summarizes the procedure for running all phases of UETP 
with default values. If you are familiar with the test package, refer to this 
section. If you need further information, refer to Section 9.2. 


1 Log into the SYSTEST account as follows: 


Username: SYSTEST 
Password: 


Note: Because the SYSTEST and SYSTEST_CLIG accounts have 
privileges, unauthorized use of these accounts might 
compromise the security of your system. 


2 Make sure no user programs are running or user volumes are 
mounted. By design, UETP assumes and requests the exclusive use of 
system resources. Unpredictable results could occur if you ignore this 
restriction. 


3 After you log in, check all devices to be sure that the following 
conditions exist: 


e All devices you want to test are powered up and are on line to the 
system. 


e Scratch disks are mounted and initialized. 


e Disks contain a directory named [SYSTEST] with OWNER_ 
UIC=[1,7]. (You can create this directory with the DCL command 
CREATE/DIRECTORY.) 
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Note: 


e Scratch magnetic tape reels are physically mounted on each drive 
you want tested and are initialized with the label UETP (using 
the DCL command INITIALIZE). Make sure magnetic tape reels 
contain at least 600 feet of tape. 


¢ Scratch tape cartridges have been inserted in each drive you want 
to test and are initialized with the label UETP. 


e Line printers and hardcopy terminals have plenty of paper. 


¢ Terminal characteristics and baud rate are set correctly (see the 
user’s guide for your terminal). 


Note that some communications devices need to be set up by Digital 
Field Service (see Section 9.3). 


If you encounter any problems in preparing to run UETP, read 


Section 9.3 before proceeding. 


To start UETP, enter the following command and press RETURN: 


$ @UETP 
UETP responds with the following question: 
Run "ALL" UETP phases or a "SUBSET" [ALL]? 


Press RETURN to choose the default response enclosed in brackets. 
UETP responds with three more questions in the following sequence: 


How many passes of UETP do you wish to run [1]? 
How many simulated user loads do you want [n]? 
Do you want Long or Short report format [Long]? 


Press RETURN after each prompt. After you answer the last 
question, UETP initiates its entire sequence of tests, which run to 
completion without further input. The final message should look like 
the following: 
KKKKKKKKEKEKKKKEKRKKKE KEK KEKKKEKRKEKRKKEKR KK KKK KKKKKKKKEKKKEKKEEKE 

* ; * 


END OF UETP PASS 1 AT 19~APR-1990 16:30:09.38 
* : . * 
FICCI IO IO IIR IOI IO RK 


After UETP runs, check the log files for errors. If testing completes 
successfully, the VMS operating system is in proper working order. 


After a run of UETP, you should always run the Error Log 
Utility to check for hardware problems that can occur during a 
run of UETP. For information on running the Error Log Utility, 
refer to the VMS Error Log Utility Manual. 


If UETP does not complete successfully, refer to Section 9.5. 


If you want to run UETP without using the default responses, refer to 
Section 9.4 through Section 9.4.4, which explain the options. 
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Obtain the SYSTEST password from your system manager. Log into the 
SYSTEST account from the console terminal as follows: 


Username: SYSTEST 
Password: 


Because SYSTEST has privileges, unauthorized use of this account 
might compromise the security of your system. 


UVETP will fail if you do not run the test from the SYSTEST account. Also, 
if you try to run. UETP from a terminal other than the console terminal, 
the device test phase displays an error message stating that the terminal 
you are using is unavailable for testing. You can ignore this message. 


After you log into the SYSTEST account, enter the command SHOW 
USERS to make sure no user programs are running and no user volumes 
are mounted. UETP requires exclusive use of system resources. If you 
ignore this restriction, UETP may interfere with applications that depend 
on these resources. 


SYSTEST Directories 


If you logged in successfully, you should be in the root directory [SYSTEST] 
on the system disk. UETP uses directories named [SYSTEST] to hold all 
the files used by UETP command procedure (UETP.COM) and temporary 
files used by UETP during testing. 


The DCL command SHOW LOGICAL displays the translation of the 
logical name SYS$TEST on a typical system: 


S$ SHOW LOGICAL SYSSTEST 
"SYSSTEST" = "SYSSSYSROOT: [SYSTEST]" (LNMSSYSTEM TABLE) 


If you want UETP to test a particular disk, such as a scratch disk, create 
either a [SYSTEST] directory or a [SYSO.SYSTEST] directory on that disk. 
Section 9.8.2 discusses setting up scratch disks for testing. 





After you log in, you need to set up the devices on the system for UETP 
testing. | 


Note: Your system may not have all the devices described in this section. 


You should check all devices to be sure that the following conditions exist: 
e All devices you want to test are turned on and are on line. 
¢ Scratch disks are mounted and initialized. 


e Disks contain a directory named [SYSTEST] with OWNER_UIC=(1,7]. 
Use the CREATE/DIRECTORY command if the [SYSTEST] directory 
does not exist on the disk. 
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e Scratch magnetic tape reels are physically mounted on each drive you 
want tested and are initialized with the label UETP (using the DCL 
command INITIALIZE). Make sure magnetic tape reels contain at 
least 600 feet of tape. 


e Scratch tape cartridges have been inserted in each drive you want to 
test and are mounted and initialized with the label UETP. 


e Line printers and hardcopy terminals have plenty of paper. 


¢ Terminal characteristics and baud rate are set correctly (see the user’s 
guide for your terminal). 


Note that some communications devices discussed in this section need to 
be set up by Digital Field Service. 


9.3.1. Setting Up the System Disk 


Before running UETP, be sure that the system disk has at least 1200 
blocks available. Note that systems running more than 20 load test 
processes, may require a minimum of 2000 available blocks. If you run 
multiple passes of UETP, log files will accumulate in the default directory 
and further reduce the amount of disk space available for subsequent 
passes. 


If disk quotas are enabled on the system disk, you should disable them 
before you run UETP. 


9.3.2 Setting Up Additional Disks 


The disk test uses most of the available free space on each testable disk in 
the following manner: 


¢ On each testable disk, the device test phase tries to create two files. 
The size of these files depends on how much free space is available on 
the disk. Usuaily the test creates each file with 5% of the free space 
on the disk. However, if the disk is nearly full, the test creates files 
that are 5 blocks. If the test cannot create 5 block files, it fails. Only 
the initial file creation can cause the device test to fail because of lack 
of disk space. — 


e The test randomly reads and writes blocks of data to the files. After 
every multiple of 20 writes for each file, the test tries to extend the 
file. The size of this extension is either 5% of the free disk space, or 5 
blocks if the file was created with 5 blocks. This process of extension 
continues until the combined space of the files reaches 75% of the free 
disk space. 


By creating and extending fragmented files in this way, UETP exercises 
the disk. This allows the test to check for exceeded quotas or a full disk, 
and to adjust for the amount of available disk space. 
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To prepare each disk drive in the system for UETP testing, use the 
following procedure: 


1 


Place a scratch disk in the drive and spin up the drive. If a scratch 
disk is not available, use any disk with a substantial amount of free 
space; UETP does not overwrite existing files on any volume. If your 
scratch disk contains files that you want to keep, do not initialize the 
disk; go to step 3. 


If the disk does not contain files you want to save, initialize it. For 
example: 


S INITIALIZE DUAL: TEST1 


This command initializes DUAI, and assigns the volume label TEST1 
to the disk. All volumes must have unique labels. 


Mount the disk. For example: 


S MOUNT/SYSTEM DUAL: TEST1 


This command mounts the volume labeled TEST1 on DUAI. The 
/SYSTEM qualifier indicates that you are making the volume available 
to all users on the system. 


UETP uses the [SYSTEST] directory when testing the disk. If the 
volume does not contain the directory [SYSTEST], you must create it. 
For example: 


$ CREATE/DIRECTORY/OWNER UIC=[1,7] DUA1: [SYSTEST] 


This command creates a [SYSTEST] directory on DUAI and assigns a 
user identification code (UIC) of [1,7]. The directory must have a UIC 
of [1,7] to run UETP. 


If the disk you have mounted contains a root directory structure, you can 
create the [SYSTEST] directory in the [SYSO.] tree. 


9.3.3 Setting Up Magnetic Tape Drives 
Set up magnetic tape drives that you want to test by doing the following: 


1 


Place a scratch volume with at least 600 feet of magnetic tape in the 
tape drive. Make sure that the write-enable ring is in place. 


Position the magnetic tape at the beginning-of-tape (BOT) and put the 
drive on line. 


Initialize each scratch magnetic tape with the label UETP. For 
example, if you have physically mounted a scratch magnetic tape 
on MTA1, enter the following command and press RETURN: 


$ INITIALIZE MTA1L: UETP 


Magnetic tapes must be labeled UETP to be tested. As a safety 
feature, UETP does not test tapes that have been mounted with the 
MOUNT command. 
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If you encounter a problem initializing the magnetic tape, or if the test 
has a problem accessing the magnetic tape, refer to the description of the 
INITIALIZE command in the VMS DCL Dictionary. 


9.3.4 Setting Up Tape Cartridge Drives 
Set up tape cartridge drives that you want to test by doing the following: 
1 Insert a scratch tape cartridge in the tape cartridge drive. 
2 Initialize the tape cartridge. For example: 


S INITIALIZE MUAO: UETP 


Tape cartridges must be labeled UETP to be tested. As a safety 
feature, UETP does not test tapes that have been mounted with the, 
MOUNT command. \ 


If you encounter a problem initializing the tape cartridge, or if the test has 
a problem accessing the tape cartridge, refer to the description of the DCL 
INITIALIZE command in the VMS DCL Dictionary. 


9.3.5 Setting Up Terminals and Line Printers 


Terminals and line printers must be turned on to be tested by UETP. They ( 
must also be on line. Check that line printers and hardcopy terminals 

have enough paper. The amount of paper required depends on the number 
of UETP passes that you plan to execute. Each pass requires two pages 

for each line printer and hardcopy terminal. 


Check that all terminals are set to the correct baud rate and are assigned 
appropriate characteristics (see the user’s guide for your terminal). 


Spooled devices and devices allocated to queues fail the initialization phase 
of UETP and are not tested. 


9.3.6 Preparing Ethernet Adapters for UETP Testing 


Make sure that no other processes are sharing the device when you run 
UETP. 


Note: UETP will not test your Ethernet adapter if DECnet or another 
application has the device allocated. 


9.3.7 Preparing the DR11—W for UETP Testing 


Note: Only Digital Field Service personnel should set up the DR11-W for 
UETP testing. 


The DR11—W uses an internal logical loopback mode that tests all 
functionality except that of module connectors, cables, and transceivers. 
Because random external patterns are generated during this operation, the | 
user device or other processor might need to be isolated from the DR11—W 
being tested until the testing is complete. 
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To test the DR11—W properly, the E105 switchpack must be set as follows: 


Switch 1 Switch 2 Switch 3 Switch 4 Switch 5 
Off On Off Off On 


When UETP testing is completed, restore the DR11—W to the proper 
operating configuration. 


9.3.8 Preparing the DRV11—W4A for UETP Testing 


Note: Only Digital Field Service personnel should set up the DRV11-WA 
for UETP testing. 


To prepare the DRV11—WA on a MicroVAX for UETP testing, be sure the 
following conditions exist: 


e The jumpers on the DRV11—WA board are set to W2, W3, and W6. 
¢ A loop-back cable is connected to the DRV11—WA board. 


e The DRV11—-WA board is in a slot from 8 to 12. If the DRV11—WaA is in 
a slot other than 8 to 12, you might get timeout errors. 


When UETP testing is completed, restore the DRV11—WA to the proper 
operating configuration. 


9.3.9 Preparing the DR750 or the DR780 for UETP Testing 


Note: Only Digital Field Service personnel should set up the DR750 or 
DR780 for UETP testing. 


To prepare the DR750 or the DR780 for UETP testing, use the following 
procedure: 


1 Copy the DR780 microcode file, XF780.ULD, from the diagnostic 
medium to SYS$SYSTEM. Use the procedure described in the 
documentation provided with the DR780 Microcode Kit. 


Turn off the power to the DR780. 

Make the following DR780 backplane jumper changes: 
¢ Remove the jumper from W7 and W8. 

¢ Add a jumper from E04M1 to E04R1. 

¢ Add a jumper from E04M2 to E04R2. 


4 Disconnect the DDI cable from the DR780. This cable is either a 
BC06V—nn cable, which can be disconnected, or a BCO6R—nn cable, 
which requires that you remove its paddle card from the backplane of 
the DR780. 


5 Restore power to the DR780. 


When UETP testing is completed, restore the DR750 or the DR780 to the 
proper operating configuration. 
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9.3.10 Preparing the MA780 for UETP Testing 


Be sure that the MA780 is set up according to the guidelines for shared 
memory in the Guide to Maintaining a VMS System. 


If you run the MA780 device test individually, the logical name 
CTRLNAME must be defined as MPM, regardless of the memory name. 
As an alternative, you can enter “MPM” in response to the controller 
designation prompt. 


9.3.11 Preparing a Second LPA11—K for UETP Testing 


If you have two LPA11~-Ks, be sure that each is given a systemwide logical 
name in the SYS$MANAGER:LPA11STRT.COM file. The logical name for 
the first LPA11—K should be LPA11$0, and the logical name for the second ’ 
LPA11—K should be LPA11$1. 


9.3.12 Devices Not Tested 


UETP does not test the following devices; their status has no effect on 
UDETP execution: 


e Devices that require operator interaction (such as card readers) 


e Software devices (such as the null device and local memory mailboxes) ( 


UDETP does not have specific tests for UDA, HSC, or CI devices; they are 
tested implicitly by the disk, magnetic tape, and DECnet tests. 


UETP also does not test the console terminal or console drives. If you boot 
the system, log in, and start UETP, you have shown that these devices can 
be used. 


Before you run UETP in a VAXcluster environment, you should check 
the SYSTEST_CLIG account. The SYSTEST_CLIG account parallels 
SYSTEST except that it is dedicated to running the cluster-integration 
test. The requirements for the SYSTEST_CLIG account are as follows: 


1 The account should be present in the user authorization file, exactly as 
distributed by Digital on each system in your VAXcluster. 


Note: The SYSTEST_CLIG account might have been disabled as part 
of the VMS upgrade procedure. If it is, you should reenable the 
SYSTEST_CLIG account and give it a null password before you 
run UETP. 
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To reenable the SYSTEST_CLIG account, enter the following 
commands and press RETURN after each one: 


S$ SET DEFAULT SYSSSYSTEM 

S$ RUN AUTHORIZE 

UAF> MODIFY /FLAGS=NODISUSER /NOPASSWORD SYSTEST_CLIG 
UAF> EXIT 


Note: Digital recommends that you disable the SYSTEST_CLIG 
account after testing has completed. 


To disable the SYSTEST_CLIG account, enter the following commands 
and press RETURN after each one: 


S$ SET DEFAULT SYSSSYSTEM 

$ RUN AUTHORIZE 

UAF> MODIFY /FLAGS=DISUSER SYSTEST CLIG 
UAF> EXIT 


2 The privileges and quotas of the SYSTEST_CLIG account should 
match those of the SYSTEST account. 


UETP requires little additional preparation for the cluster-integration 
test phase beyond the requirements for other UETP test phases. The 
additional requirements for cluster integration testing are as follows: 


1 Your system must be a member of a VAXcluster. If it is not, UETP 
displays a message and does not attempt to run the test. 


2 Your system must use the same deadlock detection interval as the 
other systems in the VAXcluster. 


3 The files VETCLIGOO.COM and UETCLIGOO.EXE, located in 
SYS$TEST, are necessary for each system included in the test. 


4 DECnet must be set up between the VAXcluster nodes; UETP uses 
DECnet to create a process on those nodes. All checks that the test 
makes depend on its ability to create the SYSTEST_CLIG processes 
and to communicate with them using DECnet. 


5 There must be a [SYSTEST] or [SYSO.SYSTEST] directory on some 
disk available to the VAXcluster for each node (both VMS and HSC) in 
the cluster. The test uses the same directory as the UETP disk test to 
create a file on each cluster node and to see if some other VMS node 
in the cluster can share access to that file. There must be one such 
directory per node; the test continues with the next cluster node once 
it has finished with a file. 


9.3.14 Preparing a Small-Disk System 


After you install the VMS operating system on a small system disk (for 
example, an RD32), you may not have the 1200 blocks of free disk space 
required to run UETP successfully. If you do not have 1200 free blocks on 
your system disk, use VMSTAILOR before you run UETP. For instructions 
on using VMSTAILOR, see Chapter 3. 
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9.3.15 Preparing DECnet 
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The DECnet phase of UETP uses more system resources than other tests, 
You can, however, minimize disruptions to other users by running the test 
on the "least busy” node. 


By default, the file VETDNET00.COM chooses the node from which the 
DECnet test will be run. To choose the node to run the DECnet test on, 
enter the following command before you invoke UETP: 


$ DEFINE/GROUP UETP$NODE_ADDRESS node_address 


This command equates the group logical name UETP$NODE_ADDRESS 
to the node address of the node in your area on which you want to run the 
DECnet phase of UETP. 


For example: 


S DEFINE/GROUP UETPSNODE ADDRESS 2.121 


When you run UETP, a router node attempts to establish a connection 
between your node and the node defined by UETP$NODE_ADDRESS. 
Occasionally, the connection between your node and the router node might 
be busy or non-existent. When this happens, the system displays the 
following error messages: 


SNCP-F-CONNEC, Unable to connect to listener 
-SYSTEM-F-REMRSRC, resources at the remote node were insufficient 


SNCP-F-—CONNEC, Unable to connect to listener 
~SYSTEM~F-NOSUCHNODE, remote node is unknown 
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When you have logged in and prepared the system and devices, you are 
ready to begin the test. 


To start UETP, enter the following command and press RETURN: 
S$ @UETP 

UETP displays the following prompt: 

Run "ALL" UETP phases or a “SUBSET" [ALL] ? 


Throughout the startup dialog, brackets indicate the default value, which 
you can choose by pressing RETURN. 


When running UETP for the first time, it is a good idea to choose the 
default value (ALL) and run all the phases. If you choose ALL, UETP 
displays three more questions, which are described in Section 9.4.2 
through Section 9.4.4. If you want to run all the test Bhaees: skip the 
next section. 
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9.4.1 Running a Subset of Phases 


You can run a single phase by entering SUBSET or S in response to the 
following prompt: 


Run "ALL" UETP phases or a "SUBSET" [ALL]? 
UETP prompts you for the phase you want to run as follows: 


You can choose one or more of the following phases: 
DEVICE, LOAD, DECNET, CLUSTER 


Phases(s): 


There is no default; enter one or more phase names from the list. Separate 
two or more phases with spaces or commas. 


If your choice includes the LOAD phase, UETP displays the three prompts 
described in the next sections. To run the LOAD phase, refer to the next 
section. 


If you exclude the LOAD phase, UETP responds with only two prompts: 


How many passes of UETP do you wish to run [1]? 
Do you want Long or Short report format [Long]? 


Section 9.4.2 and Section 9.4.4 discuss these questions. After you answer 
both questions, the phase you have selected runs to completion. 


9.4.2 Single Run Versus Multiple Passes 


If you specified the default ALL or a subset of phases at the last prompt, 
UETP displays the following message: 


How many passes of UETP do you wish to run [1]? 


You can repeat the test run as many times as you want. If you enter 1 in 
response to the prompt (or press RETURN for the default), UETP stops 
after completing a single run. If you specify a number greater than 1, 
UETP restarts itself continuously until it completes the number of passes 
(runs) specified. 


You can run UETP once to check that the system is working, or many 
times to evaluate the system’s response to continuous use. For example, 

a field service technician who is interested only in verifying that a newly- 
installed system works might run UETP once or twice. A manufacturing 
technician might let the system run for several hours as part of the system 
integration and test. 


When you specify multiple UETP runs, you might want to request a short 
console log (see Section 9.4.4). Make certain that all line printers and 
hardcopy terminals have enough paper, because each run requires two 


pages. 
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9.4.3. Defining User Load for Load Test 


Note: 


After you specify the number of passes, UETP prompts you as follows: 


How many simulated user loads do you want [n]? 


UETP displays this prompt only if you choose to run the LOAD 
phase, either implicitly (by running all phases), or explicitly (by 
running a subset and specifying the LOAD phase). 


The load test simulates a situation in which a number of users (detached 
processes) are competing for system resources. In response to this prompt, 
enter the number of users you want to simulate for this test. The number 
in brackets is the default value that UETP computed for your system. 
The default value depends on the amount of memory and the paging and 
swapping space that your system has. 


Although the given default value is the best choice, you can increase or 
decrease the user load by entering your own response to the prompt. 
However, be aware that an increase might cause the test to fail because of 
insufficient resources. 


If you want to see UETP display the user load equation as it runs, see 
Section 9.5.2. 


9.4.4 Long and Short Report Format 
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The following prompt allows you to choose one of two console report 
formats: 


Do you want Long or Short report format [Long]? 


If you choose the long report format (the default), UETP sends all error 
messages as well as information on the beginning and end of all phases 
and tests to the console terminal. UETP records all its output in the 
UETP.LOG file, regardless of your response to this question. 


In many cases, it may not be convenient to have UETP write the bulk of 
its output to the terminal. For example, if you ran UETP from a hardcopy 
terminal, the output printing can slow the progress of the tests. This delay 
may not be a problem if you have requested only one run; however, you ~ 
may prefer to use the short format if you intend to run multiple passes of 
UETP from a hardcopy terminal. 


If you request the short format, UETP displays status information at the 
console, such as error messages and notifications of the beginning and 
end of each phase. This information enables you to determine whether 
UETP is proceeding normally. If the short console log indicates a problem, 
you can look at UETP.LOG for further information. UETP.LOG contains 
all the output generated by the various phases, as well as the status 
information displayed at the console. 


After you choose the report format, UETP initiates its sequence of tests 
and runs to completion. If UETP does not complete successfully, refer to 
Section 9.5 for troubleshooting information. 


9.4.5 Termination of U 


9.4.5.1 
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ETP 


At the end of a UETP pass, the master command procedure UETP.COM 
displays the time at which the pass ended. In addition, UETP.COM 
determines whether UETP needs to be restarted. (You can request 
multiple passes when you start up the test package; see Section 9.4.2). 


At the end of an entire UETP run, UETP.COM deletes temporary files and 
does other cleanup activities. 


Pressing CTRL/Y or CTRL/C lets you terminate a UETP run before it 
completes normally. Normal completion of a UETP run, however, includes 
the deletion of miscellaneous files that have been created by UETP for 
the purpose of testing. The use of CTRL/Y or CTRL/C might interrupt or 
prevent these cleanup procedures. 


The effect of these control characters depends on what part of UETP you 
are executing. For an explanation of the organization of UETP and its 
components, refer to Section 9.6. 


Using CTRL/Y 
Press CTRL/Y to abort a UETP run. Note, however, that cleanup of files 
and network processes in the [SYSTEST] directory may not be complete. 


If you are running an individual test image, pressing CTRL/Y interrupts 
the current UETP test and temporarily returns control to the command 
interpreter. While the test is interrupted, you can enter a subset of DCL 
commands that are executed within the command interpreter and do not 
cause the current image to exit. The VMS DCL Concepts Manual contains 
a table of commands that you can use within the command interpreter. In 
addition, you can enter any of the following commands: 


¢ The CONTINUE command continues the test from the point of 
interruption (except during execution of the cluster test). 


e The STOP command terminates the test; the test aborts and control 
returns to the command interpreter. 


Note: Using the STOP command may prevent cleanup procedures 


from executing normally. You should use the EXIT command 
if you want the image to do cleanup procedures before 
terminating. 


¢ The EXIT command does cleanup procedures and terminates the test 
(except during execution of the cluster test); control returns to the 
command interpreter. 


If you enter any DCL command other than CONTINUE, STOP and EXIT, 
the test does cleanup procedures and terminates, and the DCL command 
executes. 
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9.4.5.2 Using CTRL/C | | 
Press CTRL/C to interrupt a UETP run. You cannot continue the same 
test phase after you press CTRL/C. UETP automatically goes to the next 
phase in the master command procedure. 


Some UETP phases react to CTRL/C by cleaning up all activity and 
terminating immediately. Such tests display the following message: 


SUETP-I-ABORTC, ‘testname’ to abort this test, type “*C 


The phases that do not display the previous message terminate all 
processes they have started. These processes might not have a chance 
to complete normal cleanup procedures. 


If you are running an individual test image, however, you can use CTRL/C 
to terminate the execution of the image and complete cleanup procedures. 


Note that CTRL/C does not complete cleanup procedures for the cluster 
test. 





9.5 Troubleshooting 


This section explains the role of UETP in interpreting operational errors 
in a VMS operating system. Section 9.5.4 discusses common errors that 
can appear in a UETP run and describes how to correct them. 


9.5.1 Relationship of UETP to Error Logging and Diagnostics 


When UETP encounters an error, it reacts like a user program. It either 
returns an error message and continues, or it reports a fatal error and 
terminates the image or phase. In either case, UETP assumes the 
hardware is operating properly and it does not attempt to diagnose the 
error. 


If the cause of an error is not readily apparent, use the following methods 


¢ VMS Error Log Utility—Run the Error Log Utility to obtain a detailed 
report of hardware and system errors. Error log reports provide 
information about the state of the hardware device and I/O request at 
the time of each error. For information about running the Error Log 
Utility, refer to the VMS Error Log Utility Manual. 


e Diagnostic facilities—Use the diagnostic facilities to test exhaustively 
a device or medium to isolate the source of the error. 


9.5.2 Interpreting UETP Output 


You can monitor the progress of UETP tests at the terminal from which 

they were started. This terminal always displays status information, such 

as messages that announce the beginning and end of each phase and 
messages that signal an error. | 
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The tests send other types of output to various log files, depending on how 
you started the tests. The log files contain output generated by the actual 
test procedures. Even if UETP completes successfully, with no errors 
displayed at the terminal, it is good practice to check these log files for 
errors. Furthermore, when errors are displayed at the terminal, check the 
log files for more information about their origin and nature. 


Each test returns a final completion status to the test controller image, 
UETPHAS00, using a termination mailbox. This completion status 

is an unsigned longword integer denoting a condition value. As a 
troubleshooting aid, UETPHAS00 displays the test’s final completion 
status using the $FAO and $GETMSG system services. Sometimes, 
however, the $FAO service needs additional information which cannot 
be provided using the termination mailbox. When this happens, UETP 
displays an error message similar to the following: 


UETP-E-ABORT, !AS aborted at !$D 


When UETP displays these types of error messages, check the log files 
for more information. You can also run the individual test to attempt to 
diagnose the problem. 


The error messages that appear at the terminal and within the log files 
have two basic sources: 


¢ UETP tests 


e¢ System components that are tested 


To interpret the messages, you might need to refer either to the VMS 
System Messages and Recovery Procedures Reference Volume or to the 
manual that describes the individual system component. 


Several parts of UETP, such as some device tests, UETINITO0O.EXE, 
UETCLIGOO.EXE, and UETDNET00.COM, let you obtain additional 
information concerning the progress of the test run or the problems it 
encounters. Because this information is usually insignificant, it 1s not 
displayed on the screen. To view the information, enter the following 
command and run the program: 


$ DEFINE MODE DUMP 


The following example shows the output for UETINITO0.EXE on a VAX 
11/750: 


$ RUN UETINITOO 
Welcome to VAX/VMS UETP Version V5.2 
SUETP-I-ABORTC, UETINITOO to abort this test, type “*C 


You are running on an 11/750 CPU with 8704 pages of memory. 
The system was booted from DRAQ:[SYS0.]. 
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Run "ALL" UETP phases or a "SUBSET" [ALL]? 
How many passes of UETP do you wish to run [1]? 


The default number of loads is the minimum result of 


1) CPU_SCALE * ((MEM FREE + MEM MODIFY) / (WS_SIZE * PER WS _INUSE)) 
0.80 * (( 8704 + 323) / { 350 * 0.20)) = 103 


2) Free process slots = 56 


3) Free page file pages / Typical use of page file pages per process 
18040 / 1000 = 18 


How many simulated user loads do you want [18]? 
Do you want Long or Short report format [Long]? 


UETP starting at 19-APR-1990 09:08:26.71 with parameters: 
DEVICE LOAD DECNET CLUSTER phases, 1 pass, 18 loads, long report. 
$ 


This program does not initiate any phase; it displays the equation used by 


UETP to determine user load and the specific factors that are employed in { 
the current run. 


You should respond to the questions by pressing RETURN. After you 
respond to the first prompt, the program displays the expressions that 
determine the default number of simultaneous processes. The following 
definitions apply: 


¢ CPU_SCALE refers to the relative processing power of the CPU in 
relation to a VAX-11/780. For example, a VAX-11/785 has a 


CPU_SCALE of 1.5 because it has 1.5 times the processing power of a 
VAX-11/780 (1.0). : 


¢ MEM_FREE represents memory in pages available to users. 
¢ MEM_MODIFY represents memory pages on the modified page list. 
e WS_SIZE represents working set size. 


e PER_WS_INUSE represents typical percentage of the working set in 
active use for each process. 


TIBRVATATTMHAN ml ~ ale want sere 4L7 eee er es TRO AIA MILA 
ULTINITOO also displays the specific values represented by the 


expressions. In this example, UETP selects 18 as the default for simulated 
user loads, because 18 is the minimum result of the three expressions. 


You should deassign the logical name MODE before running UETP, unless 
you prefer to see the previous breakdown every time you run UETP. 


Defining a Remote Node for UETP Ethernet Testing 

Occasionally during the UETUNAS00 test, it is difficult to determine 
whether the problem reports concern the device under test or the remote 
device. The easiest way to ensure proper error reporting is to define a 
“good turnaround.” A “good turnaround” is a remote node that you know 
turns around Ethernet packets correctly and is up and waiting in the 
ready state. 


You can make the UVETUNAS00 test use a known “good turnaround” by 
performing the following actions. In the commands that follow, assume 
that the “good” device is on node BETA, and that node BETA is already 
defined in the network database. 


9.5.3 


Running UETP 
9.5 Troubleshooting 


Find the address of the “good” Ethernet node by using the Network 
Control Program (NCP). In order to use NCP, the following conditions 
must apply: 


e DECnet must be up and running on the system. 


e The account you are using must have TMPMBX and NETMBX 
privileges. 


Enter the following commands and press RETURN: 


S RUN SYSSSYSTEM:NCP 

NCP> TELL BETA SHOW CHARACTERISTICS ACTIVE LINES 

If node BETA has not been defined in your network database, NCP 
displays an error message. In this event, specify another “good” node 
and retry the command. Otherwise, see your system or network 
manager. 


NCP displays information similar to the following: 


Active Line Volatile Characteristics as of 19-APR-1990 16:13:02 
Line = UNA-0O. 


Counter timer = 28800 

Receive buffers = 6 

Controller = normal 

Protocol = Ethernet 

Service timer = 4000 

Hardware address = AA-00-04-00-46-D3 
UNA device buffer size = 1498 


2 


Use the displayed hardware address (in this case, AA0N0040046D3) to 


define the logical name TESTNIADR to point to the “good turnaround.” 


The Log Files © 


Note that you do not specify the hyphens (-). 


First, log in to the SYSTEST account. Then enter the following 
command: 


S DEFINE/SYSTEM TESTNIADR AA00040046D3 
Run UETP. 


When UETP has completed, deassign the logical name TESTNIADR 
by entering the following command: 


S DEASSIGN/SYSTEM TESTNIADR 


At the end of a UETP run, the directory SYS$TEST contains a log file 
named UETP.LOG. This file contains all information generated by all 
UETP tests and phases. If the run involves multiple passes, you will find 
a version of UETP.LOG for each pass. 


Although UETP.LOG contains information from all the passes, only 
information from the latest run is stored in this file. Information from 


the 


previous run is stored in a file named OLDUETP.LOG, which also has 


a version for each pass. Using these two files, UETP provides the output 
from its tests and phases from the two most recent runs. 
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The cluster test creates a NETSERVER.LOG file in SYS$TEST for 
each pass on each system included in the run. If the test is unable to 
report errors (for example, if the connection to another node is lost), the 
NETSERVER.LOG file on that node contains the result of the test run 
on that node. UETP does not purge or delete NETSERVER.LOG files; 
therefore, you must delete them occasionally to recover disk space. 


If a UETP run does not complete normally, SYS$TEST might contain 
other log files. Ordinarily these log files are concatenated and placed 
within UETP.LOG. You can use any log files that appear on the system 
disk for error checking, but you must delete these log files before you run 
any new tests. You may delete these log files yourself or rerun the entire 
UETP, which checks for old UETP.LOG files and deletes them. 


Possible UETP Errors 


This section is intended to help you identify and solve problems you might 
encounter running UETP. You should refer to this section if you need help 
understanding a system failure and isolating its cause. This section is not 
intended as a repair manual and is not expected to diagnose any flaws in 
your system. It should, however, help you to interpret and act upon the 
information in the error messages. 


If you are unable to correct an error after following the steps in this 
section, you should contact your Digital Field Service representative. Any 
information you can supply about the measures you have taken to isolate 
the problem will help your Digital Field Service representative diagnose 
the problem. 


The following are the most common failures encountered while running 
UETP: 


Wrong quotas, privileges, or account 
DETINITO1 failure 
Insufficient disk space 


uw, 


Incorrect VAXcluster setup | 
Problems during the load test 
DECnet error 

Errors logged but not displayed 
No PCB or swap slots 

Hangs 


oO nN OO oO F- |W ND 


10 Bugchecks and machine checks 


The following sections describe these errors and offer the best course of 
action for dealing with each one. 
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9.5.4.1 Wrong Quotas, Privileges, or Account 
If your assigned quotas or privileges do not match standard quotas and 


privileges for the SYSTEST account, UETP displays the following error 


message: 
KKKEKEKEKEKEKKKKEKEKKKKKEKKKEHE 
* UETINITOO * 
* Error count = l] * 


KKEKEKKKKKKKKKEKKKKKKEKK 


-UETP-W-TEXT, The following: 


OPER privilege, 
BIOLM quota, 
ENQLM quota, 
FILLM quota, 


are nonstandard for the SYSTEST account and may result in UETP errors. 


This message informs you that the OPER privilege and the BIOLM, 
ENQLM, and FILLM quotas either are not assigned correctly or are not 
assigned at all. 


Note: UETP displays a similar message if you run the cluster integration 
test phase, and the privileges and quotas for the SYSTEST_CLIG 
account are incorrect. The SYSTEST and SYSTEST_CLIG accounts 
require the same privileges and quotas. Take the same action 


described in this section. 


solution 
To correct the problem, use the following procedure: 


1 Display all privileges and quotas in effect for the current account 
using the DCL commands SHOW PROCESS/PRIVILEGE and SHOW 
PROCESS/QUOTA as follows: 


S SHOW PROCESS/PRIVILEGES 


19-APR-1990. 18:06:02.89 OPAO: User = SYSTEST 
Process privileges : 
CMKRNL may change mode to kernel 
CMEXEC may change mode to exec 
SYSNAM may insert in system logical name table 
GRPNAM may insert in group logical name table 
DETACH may create detached processes 
DIAGNOSE may diagnose devices 
LOG IO may do logical I/0 
GROUP may affect other processes in same group 
PRMCEB may create permanent common event clusters 
PRMMBX may create permanent mailbox 
SETPRV may set any privilege bit 
TMPMBX may create temporary mailbox 
NETMBX may create network device 
VOLPRO may override volume protection 
PHY IO may do physical I/O 
SYSPRV may access objects via system protection 


S SHOW PROCESS/QUOTAS 


19-APR-1990 18:06:03.36 OPAO: User: SYSTEST 

Process Quotas: 
Account name: SYSTEST 
CPU limit: Infinite Direct I/O limit: 55 
Buffered I/O byte count quota: 32768 Buffered I/O limit: 18 
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Timer queue entry quota: 20 Open file quota: 100 
Paging file quota: 19543 Subprocess quota: 8 
Default page fault cluster: 64 AST limit: 98 
Enqueve quota: 300 Shared file limit: 0 
Max detached processes: 0 Max active jobs: 0 


2 Check that the privileges and quotas assigned to the account match 
the following: 


Privileges 


CMKRNL CMEXEC NETMBX DIAGNOSE 
DETACH PRMCEB PRMMBX PHY_IO 
GRPNAM TMPMBX VOLPRO LOG_IO 
SYSNAM SYSPRV SETPRV GROUP 


Quotas 

BIOLM: 18 PRCLM: 8 

DIOLM: 55 ASTLM: 100 

FILLM: 100 BYTLM: 32768 
TQELM: 20 CPU: no limit 
ENQLM: 300 PGFLQUOTA: 20480 
WSDEFAULT: 256 WSQUOTA: 512 


WSEXTENT: 2048 


3 If any privileges or quotas are incorrect, run the Authorize Utility 
(AUTHORIZE) to add them (AUTHORIZE is explained in the 
VMS Authorize Utility Manual). As an alternative, you can 
temporarily assign the correct privileges with the DCL command 
SET PROCESS/PRIVILEGES. 


If you are logged in to the wrong account, the following error message asks 
you to log in to the SYSTEST account: 


$ @UETP 


RAEKKKKEKRKEKKRKKKKKKKKEERE 


* UETINITOO e 


*x* Error count = 1 * 
KRKEKKKKKEKEKEKKKEKEKKEKRKE EKER 


-UETP-E-ABORT, UETINITOO aborted at 19-APR-1990 14:24:10.13 
-UETP~E-TEXT, You are logged in to the wrong account. 

Please log in to the SYSTEST account. 
$ 


You must run UETP from the SYSTEST account. 
UETINITO1 Failure 


UETINITO1 failures are related to peripheral devices; this type of error 
message might indicate any of the following: 


¢ Device failure 
e Device not supported or not mounted 


¢ Device allocated to another user 
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e Device write-locked 
¢ Lost vacuum on a magnetic tape drive 


e Drive off line 


In some cases, the course of action you should take is explicit in the error 
message. For example, you might receive a message from the Operator 
Communication Facility (OQPCOM) process informing you of a problem and 
recommending a corrective measure: 


SOPCOM, 19-APR-1990 14:10:52.96, request 1, from user SYSTEST 
Please mount volume UETP in device _MTAO: 
SMOUNT-I-OPROST, Please mount volume UETP in device _MTAO: 


Other error messages might relate information in which the solution is 
implicit: 
SUETP-S-BEGIN, UETDISKOO beginning at 19-APR-1990 13:34:46.03 


KREKKKKKKRKAKKKKKKKKKKKEK 
* DISK DRA ss 


* Error count = 1 * 
KEE KR KKK KEKKEKKKEKEKEEKESE 


~UETP-E-TEXT, RMS file error in file DRAO:DRAOO.TST 
-~RMS-E-DNR, device not ready or not mounted 
SUETP-S-ENDED, UETDISKOO ended at 19-APR-1990 13:34:46.80 


This message tells you that a disk drive is either not ready or not 
mounted. From this information, you know where to look for the cause of 
the failure—at the disk drive. If you cannot see the cause of the problem 
immediately, check the setup instructions in Section 9.3. 


In other cases, the cause of a failure might not be obvious from the 
information in the message. The problem might be related to hardware 
rather than software. For example, the Ethernet adapter test may produce 
one of the following messages if UETP does not have exclusive access to 
the Ethernet adapter: 


e Inter-module cable unplugged 
e Self-test failure code 0000000 


To run the self-test diagnostic on the Ethernet adapter successfully, UETP 
needs exclusive access to the adapter. Because either DECnet or the LAT 

terminal server might also want to use the Ethernet adapter (a shareable 

device), UETP requires that you shut down DECnet and the LAT terminal 
server before you run the device test phase. 


Solution 


To determine where or when the failure occurs in the execution of UETP, 
use the following procedure: 


¢ Run the device test individually (see Section 9.4.1). By doing this, you 
can determine if the failure can be re-created. Also, you are isolating 
the cause of the problem by reproducing it using the least amount of 
software possible. For example, if the failure occurs only when you 
run the entire device phase, and not when you run the affected device 
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9.5.4.3 


test individually, you can conclude the problem is related to device- 
interaction. Conversely, if you can re-create the error by running the 
single device test, then you have proved that the error is not related to 
device interaction. 


e Run the device test with different media. If your run of the single 
device test succeeded in reproducing the error, the magnetic tape or 
disk media could be defective. Running the same test with new media 
determines whether this is the problem. 


e Call Digital Field Service. If you have tried all the previous steps 
without solving the problem, you should contact your Digital Field 
Service representative. 


Insufficient Disk Space 

When you run continuous passes of UETP, log files accumulate on the 
disk from which UETP was run. These files reduce the amount of free 
disk space available for each successive pass. If the amount of disk space 
available becomes too small for the current load, the following error 
message appears: 


SUETP-S-BEGIN, UETDISKOO beginning at 19-APR-1990 08:12:24.34 
SUBTP-I-ABORTC, DISK DJA to abort this test, type *C 


KOK KKK KK KK KKK KK KR KKK 
* DISK DJA * 


*K--+.Brror count = 1 Le 
KHIKKKEKEKKEKKEKKKKKEKKKKEE EK 


-UETP-F-TEXT, RMS file error in file DJAO:DJA00.TST 
-RMS-F-FUL, device full (insufficient space for allocation) 


KREKKKRKKRKEKEKKKKEKKKKEKREKEE 


* DISK DJA . 


* Brror count = Z * 
KEEEKRKEKR RRR KEKE KEKE EEE : 


-UETP-F-TEXT, RMS file error in file DJAQ:DJA01.TST 

-~RMS-F-FUL, device full (insufficient space for allocation) 
SUETP—-E-DESTP, DISK DJA stopped testing DJA unit 0 at 08:12:36.9] 
SUETP-S-ENDED, UETDISKOO ended at 19-APR-1990 08:12:37.98 


Solution 


Make more space available on the disk. You can do this by using one or 
more of the following techniques: 


¢ Delete unnecessary files to create more space. 
¢ Purge files, if multiple versions exist. 
¢ Mount a volume with sufficient space. 


e Check for disk quotas that may be enabled on the disk. If disk quotas 
are enabled, either disable or increase them (see the VMS SYSMAN 
Utility Manual for a description of the Disk Quota Utility). 


¢ Run VMSTAILOR if you have a small-disk system. See Chapter 3 for 
more information. 


See Section 9.2.1 and Section 9.3.2 for a further discussion of disk space. 


9.5.4.4 
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Incorrect Setup of a VAXcluster 

Most problems that can occur during the cluster-integration test are 
related to improper setup of the VAXcluster or of UETP on the VAXcluster. 
These problems are most likely to occur at the following stages of the 
VAXcluster test: 


e Near the beginning, when processes on VMS nodes are started 


e Toward the end, when cluster file access is checked 


The cluster test phase shows that various VMS nodes in your cluster can 
simultaneously access files on selected nodes in the cluster. First, UETP 
tries to create a file on a disk drive that is accessible to the other selected 
nodes in the cluster. The following are the requirements for creating a file 
in the cluster test phase: 


e There must be a [SYSTEST] directory on the disk in either the master 
file directory (MFD) or in the root directory [SYSO.]. 


e The [SYSTEST] directory must be protected so that the SYSTEST 
account can create a file in it. 


If UETP is unable to find a suitable device on a certain node, the test 
displays a warning message and proceeds to the next cluster node. 


Nodes on which the operator’s terminal (OPAO) is set to the "No Broadcast” 
terminal characteristic will generate the following error message during 
the cluster test: 


KEKRKKKKKKKKKKKKKKKEKKK 


* UETCLIGOOmaster 
* Error count = 


1 


* 
* 


KEKKKKKKKKKKKKKKEKEKKESK 

-~UETP-E-TEXT, O operator consoles timed out on the cluster test warning 
and 1 operator console rejected it. 

-UETP-E-TEXT, Status returned was, 
"SSYSTEM-F-DEVOFFLINE, device is not in configuration or not 


available" 


Disregard this message if OPAO is set to “No broadcast”. 


Solution 


Whenever you suspect a problem, you should try to recover the 
SYS$TEST:NETSERVER.LOG file that was created when the SYSTEST_ 
CLIG process was created. This file may contain additional error 
information that could not be transmitted to the node running the test. If 
it was not possible to create the SYSTEST_CLIG process on some node, 
the system accounting file for that node may contain a final process status 
in a process termination record. 


The following problems can occur during a cluster test: 


¢ Logging in at other nodes—This problem is due to incorrect setup for 
the cluster test at the remote VMS node. For example, if you specified 
a password for the SYSTEST_CLIG account or if you disabled the 
SYSTEST_CLIG account, the test displays the following message: 


S$SYSTEM-F-INVLOGIN, login information invalid at remote node 
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Refer to Section 9.3.13 and Section 9.5.2.1 for information on preparing 
for VAXcluster testing. 


¢ Communicating with other nodes—A message indicates a DECnet 
problem. Check the NETSERVER.LOG file on the affected node to 
determine the cause. 


e Taking out locks or detecting deadlocks—The most likely cause of 
this problem is that you are not logged in to the SYSTEST account. 
Another possibility is that your cluster is not configured properly. 


e Creating files on VAXcluster nodes—This problem is due to incorrect 
’ getup for the cluster test; refer to Section 9.3.13 for information on 
preparing for VAXcluster testing. 


Problems During the Load Test 

A variety of errors can occur during the load test because the command 
procedures that are started during the tests run several utilities and do 
many functions. Tracking a problem can be difficult because UETP deletes 
the log files that are generated during the load test (see Section 9.6.3). 


Solution 


If a problem occurs during the load test and the cause is not obvious, you 
can modify UETP.COM to preserve the log files as follows: 


1 Add the /NODELETE qualifier to the following line: 


S$ TCNTRL UETLOAD00.DAT/PARALLEL: COUNT=' LOADS/REPORT_TYPE=' REPORT 
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2 Delete the following line: 


S$ DELETE UETLO*.LOG; * 


Rerun the load test with these changes to try to re-create the problem. 


If you re-create the problem, look at the contents of the appropriate log 
file. You can determine which log file to read by understanding the scheme 
by which the load test names its processes and log files. (The log file 
names are derived from the process names.) 


The load test creates processes that are named in the following format: 
UETLOADnn _nnnn 
For example: 


SUETP-I-BEGIN, UETLOADOO beginning at 19-APR-1990 15:45:08.97 


SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I~-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 


UETLOADO02 0000 
UETLOADO3 0001 
UETLOADO4 0002 
UETLOADO5 0003 
UETLOADO06 0004 
UETLOADO7_ 0005 
UETLOADO8 0006 
UETLOADO09_ 0007 
UETLOAD10 0008 
UETLOAD11 0009 
UETLOADO02_0010 
UETLOADO3 0011 
UETLOAD04 0012 


beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 


at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 


19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
L9-APR=1990 
LE9-APR=1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
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Note that if more than ten processes are created, the numbering 
sequence for the UETLOADnn portion of the process name starts over 

at UETLOAD02; however, the four digits of the _nnnn portion continue to 
increase. 


Each load test process creates two log files. The first log file is created by 
the test controller; the second log file is created by the process itself. The 
log file that you need to look at for error information on any given load 
test process is the one that was created by the test controller (the first log 
file). 


The load test log file derives its file name from the process name, 
appending the last four digits of the process name (from the _nnnn 
portion) to UETLO. The test-controller log file and the process log file 
for each process use the same file name; however, the process log file has 
the higher version number of the two. For example, the log files created 
by the process UETLOAD05_0003 would be named as follows: 


UETLOO0003.LOG;1 (test-controller log file) 
UETLOO0003.LOG;2 (process log file) 


Make sure that you look at the log file with the lower version number; 
that file contains the load test commands and error information. 


After you have isolated the problem, restore UETP.COM to its original 
state and delete the log files from the load test (UETLO*.LOG;*); failure 
to delete these files might result in disk space problems. 


DECnet Error 
A DECnet error message might indicate that the network is unavailable. 


Solution 


¢ If DECnet is included in your system, register the authorization key 
(see the VMS Release Notes). 


¢ If DECnet is not included in your system, ignore the message; it is 
normal and does not affect the UETP run. 


If you encounter other DECnet-related errors, you should do the following: 


¢ Run DECnet as a single phase (see Section 9.4.1) to determine whether 
the error can be re-created. 


¢ Refer to the VMS System Messages and Recovery Procedures Reference 
Volume. | 


Errors Logged but Not Displayed 

If no errors are displayed at the console terminal or reported in the 
UETP.LOG file, you should run the Error Log Utility to see if any errors 
were logged in the ERRLOG.SYS file. See the VMS Error Log Utility 
Manual for information about running the Error Log Utility. 
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9.5.4.8 No PCB or Swap Slots 


The following error message indicates that no process control block (PCB) 
or swap slots are available: 3 


SUETP-I-BEGIN, UETLOADOO beginning at 19-APR-1990 07:47:16.50 
SUETP-I-BEGIN, UETLOADO2 0000 beginning at 19-APR-1990 
SsUETP-I-BEGIN, UETLOADO3 0001 beginning at 19-APR-1990 
SUETP-I-BEGIN, UETLOADO4 0002 beginning at 19-APR-1990 
SUETP~I-BEGIN, UETLOADOS5 _ 0003 beginning at 19=APR-1990 
SUETP-I-BEGIN, UETLOADO6 | 0004 beginning at 19-APR-1990 
SsUETP-W-TEXT, The process -UETLOADO7 0005- was unable to be created, 


the error message is 
~SYSTEM-F-NOSLOT, no pcb or swap slot available 
the error message is 


the error message is 


the error message is 


SUETP-W-TEXT, The process -UETLOADO8 0006- was unable to be created, 
-SYSTEM-F-NOSLOT, no pcb or swap slot available 
SUETP-W-TEXT, The process -UETLOAD09 0007- was unable to be created, 
-SYSTEM-F-NOSLOT, no pcb or swap slot available 
sUETP-W-TEXT, The process -UETLOAD10 0008- was unable to be created, 
-~SYSTEM-F-NOSLOT, no pcb or swap slot available 

to be created, 


SsUETP-W-TEXT, The process —-UETLOAD11 0009- was unable 
the error message is 


OF 
Did 
OT: 
O7: 
O7: 


47:16.76 
ATS 16492 
SIS Lasko 
4713h7.395 
47:17.61 


~SYSTEM-F-NOSLOT, no pcb or swap slot available 
SUETP-W-ABORT, UETLOADOO aborted at 19-APR-1990 07:47:54.10 
-UETP-W-TEXT, Aborted via a user CTRL/C. 


KKKEKKKKKKKKKKKKKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKEKKK 


x 


* 


END OF UETP PASS 1 AT 19-APR-1990 07:48:03.17 


* 


*k 


KKEKEKKREKKKEKKEKKKEKKKKKKEKKKKKKKKKEKKKEKKEKKKKKKKKKKEKKEKE 


Solution 


To solve this problem, use the following procedure: 





1 Rerun individually the phase that caused the error message (the 
LOAD phase in the previous example) to see if the error can be 
reproauced. 

2 Increase the size of the page file, using either the command procedure 

_ SYS$UPDATE:SWAPFILES.COM or the System Generation Utility 
(see the VMS System Generation Utility Manual. 

3 Increase the SYSGEN parameter MAXPROCESSCNT, if necessary, 
and reboot the systein. - 

4 Increase both the page file size and the MAXPROCESSCNT, if 
necessary. 

9.5.4.9 Hangs 


If there is no seypaare response or system disk activity, the system may 
be hung. 
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Solution 


A system hang can be difficult to trace; you should always save the dump 
file for reference. To learn why the system hung, run the System Dump 
Analyzer as described in the VMS System Dump Analyzer Utility Manual. 
Reasons for a system hang include the following: 


¢ Insufficient pool space—Reboot the system with a larger value for 
NPAGEVIR. 


e Insufficient page file space—Increase the page file space using the 
System Generation Utility as described in the VMS System Generation 
Utility Manual. 


e I/O device failure causing driver-permanent loop—Call Digital Field 
Service. 


9.5.4.10 Bugchecks and Machine Checks 
When the system aborts its run, a bugcheck message appears at the 
console. 


Solution 


Call Digital Field Service. Often a hardware problem causes bugchecks 
and machine checks; there is no easy way to solve bugchecks 

or machine checks. It is important, however, that you save the 
SYS$SYSTEM:SYSDUMP.DMP and ERRLOG.SYS files so that they 
are available for examination. It is also important to know whether the 
failure can be recreated; you can verify this by running UETP again. 


9.6 UETP Tests and Phases 


This section explains in detail the organization of UETP and the individual 
components within the test package. 


You run UETP by starting a master command procedure containing 
commands to start each test phase. The procedure begins by prompting 
you for information needed by the various test phases. (See Section 9.4 for 
a detailed description of starting UETP.) 


The master command procedure, UETP.COM, contains commands that 
initiate each test phase. UETP.COM also contains commands that do such 
tasks as defining logical names and manipulating files generated by the 
tests. 


The UETP.COM procedure also issues commands to start the test 
controlling program, UETPHAS00.EXE, which, in turn, controls each 
test phase. The test controller starts up multiple detached processes. It 
also reports their completion status and other information the processes 
report to it. 


The following sections describe the various UETP test phases. 
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9.6.1 Initialization Phase 


The following occurs during the initialization phase: 


¢ The image UETINITOO.EXE prompts you for information (see 
Section 9.4). Your information defines variables that affect the 
execution of UETP tests. 


¢ The image UETINITO1.EXE gathers information on all the controllers 
in the system and on their associated devices. This image writes the 
information into a file called UETINIDEV.DAT. 


e Using the information in UETSUPDEV.DAT, UETINIT01.EXE 
verifies which devices in the system are operable by running the 
appropriate device test. Each device test completes a simple read/write 
operation to each device. If a device fails this test, the device’s entry 
in UETINIDEV.DAT specifies that the device cannot be tested. As a 
result, subsequent UETP tests ignore that device. 


e For each testable controller, UETINITO1.EXE writes a line into a 
file called UETCONTO0.DAT. The line associates a test file with the 
controller it tests. 


A summary of UETINIDEV.DAT always exists in UETP.LOG, and 
UETINITO1.EXE sends that summary to the console if you have requested 
the long report format. 


9.6.2 Device Test Phase 


9.6.2.1 


The device test phase includes separate tests for each type of device, such 
as disk, magnetic tape, line printer, and terminal. This section explains 
the device test phase and presents instructions for testing a single device. 
If you want to run the entire device test phase individually, refer to 
Section 9.4.1. 


How the Device Phase Works 

The UETP device test phase starts an executable image, the phase 
controller UETPHAS00, which creates a detached process for every device 
controller to be tested. For example, if a system includes three terminal 
controllers, one line printer controller, and two disk controllers, the image 
creates six detached processes. In parallel, the detached processes execute 
images that test the various types of devices. 


The initialization phase of UETP creates a file called UETINIDEV.DAT 
and a file called UETCONT00.DAT. UETINIDEV.DAT contains data on 
the VMS-supported controllers in the system and their associated devices; 
UETCONTO00.DAT associates a device test image with each testable 
controller. 


UETPHAS00 uses the information in UETCONTO0.DAT to find a 
device controller name to pass to each detached process that it creates. 
UETPHAS0O0 passes the controller name by writing it to a mailbox that 
is SYS$INPUT to individual tests. Each detached process uses that 
data to determine which controller to test. The test image then searches 
UETINIDEV.DAT for the device controller and for all testable units on 
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that controller. The phase controller terminates when all devices on all 
controllers have completed testing. 


Because UETCONT00.DAT is deleted automatically at the end of a UETP 
run, you cannot run the device phase unless you start UETP.COM; you can 
run only individual test images. UETINIDEV.DAT exists in SYS$TEST 
unless you explicitly delete it. 


Running a Single Device Test 

You must be logged in to the SYSTEST account to run the individual tests 
as described in this section. Also, a copy of UETINIDEV.DAT must exist. 
If a copy of the file is not present from a previous run (a run of the entire 
UETP or a run of the device test phase creates UETINIDEV.DAT), you can 
create it. Note that when you run a single test, no log file is created; the 
test sends all its output to your terminal. 


If you do not want to test all the device types, you can test a specific 
controller by choosing a test image name from Table 9-1 and executing it 
as in the following example: 


$ RUN UETTTYSOO 
Controller designation?: TTB 


-UETP prompts you for the controller designation and the device code. 


Unless you are testing your own terminal, you must explicitly designate 
a controller name. If you are running the terminal test, you can press 
RETURN to test your terminal only. 


If you plan to repeat the run several times, you might find it more 
convenient to define the logical name CTRLNAME as follows: 


$ DEFINE CTRLNAME TTB 


~§ RUN UETTTYSOO 


When you define the controller name in this way, the logical name 
CTRLNAME remains assigned after the test completes. To deassign 
this logical name, use the DCL command DEASSIGN as follows: 


§ DEASSIGN CTRLNAME 


Format of UETINIDEV.DAT 


The UETINIDEV.DAT file is an ASCII sequential file that you can type 
or edit if necessary. The contents of this file are shown in the following 
command sequence: 


S$ TYPE UETINIDEV.DAT 


‘DDB x ddd _ 


UCB y uuuuUu 
END OF UETINIDEV.DAT 


The symbols in this example are defined as follows: 
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Symbol Value 


Xx T, if there are any testable units for this controller; N, if this controller is not 


to be tested 
y T, if this unit is testable; N, if this unit is not testable 
ddd device controller name; for example DUA 
UUUUU device unit number, for example 25 


UETINIDEV.DAT contains a DDB (device data block) line for each 


controller connected or visible to your system. After the DDB line there is 
a UCB (unit control block) line for each unit connected to that controller. 
In addition, if your system uses MA780 memory in a loosely coupled CPU 
configuration, UETINIDEV.DAT includes one UCB line for each MA780 
memory. A device test can test a particular device only if both the DDB 
line and the UCB line indicate that the device is testable. 


Running a Test in Loop Mode 


If you want to put extra stress on a device, you can run the device test in 
loop mode, which causes the test to run indefinitely. For example: 

S$ DEFINE MODE LOOP 

$ RUN UETDISKOO 


Controller designation?: DRA 
SUETP-I-TEXT, End of pass 1 with 980 iterations at 19-APR-1990 16:18:51:03 


Nm 


LL 


You must use CTRL/C to terminate the test run. If you use CTRL/Y, UETP 
does not complete cleanup procedures. 


Functions of Individual Device Tests 


For each disk in the system, the disk test allocates two files into which it 
randomly writes blocks of data. The test then checks the data, reports any 
errors to SYS$OUTPUT, and deletes the disk files. 


Th 4 en Tesat ; t tha taat 
When you run the disk test phase in a cluster environment, the test 


accesses all disks that are mounted by the system being tested, and 
users of the disk being tested might encounter an insufficient disk space 
problem. You should warn users on remote nodes (who share disks with 
users on the local system) that UETP may be testing a disk they are using. 


The magnetic tape test exercises all the magnetic tape drives in the 
system. The test creates a large file on each mounted magnetic tape, into 
which it writes multiple sequential records of varying sizes. After writing 
the records, the test rewinds the magnetic tape, validates the written 
records, and reinitializes the magnetic tape. 


The terminal and line printer test generates several pages or screens of 
output, in which each page or screen contains a header line and a test 
pattern of ASCII characters. A header line contains the test name, the 
device name, the date, and the time. 


For the laboratory peripheral accelerator (LPA11—K), the test image 
determines the configuration on the LPA11—K’s I/O bus. The image loads 
all types of microcode to the LPA11—K and reads or writes data for each 
device on the LPA11—K I/O bus. 
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The communications device tests fill the transmit message buffer with 
random data; then, using loopback mode, the tests transmit and receive 
the message several times. To check that the looped-back data is correct, 
an AST routine is associated with a $QIO read to compare the received 
message against the transmitted message. The procedure is repeated 
using messages of different lengths. 


_ The interface device tests put the devices they are testing in maintenance 
mode, write random data, and then verify the data. 


The MA780 device test creates and modifies mailboxes, common event 
flags, and global sections in shared memory; then it verifies that 
modifications can be made. You can run MA780 tests in parallel from 
separate systems so that the tests interact with each other through 
common MA780 memories. 


The Ethernet adapter test does self-test diagnostics on the device. It also 
does read and write tasks with test data that uses various adapter modes 
(such as internal loopback and external loopback). 


Table 9-1 lists the device test images and the devices to be tested. 


Tabie 9-1 The Device Tests 


Test Image Name Devices Tested 

UETDISKO0.EXE Disks 

UETTAPEOO.EXE - Magnetic tape drives and tape cartridge drives 
UETTTYSOO.EXE Terminals and line printers 

UETLPAKOO.EXE LPA11—-K 

UETCOMS00.EXE DMC11, DMR11 

UETDMPF00.EXE DMF32, DMP11 

UETDR1W00.EXE DR1i-—W 

UETDR7800.EXE DR780, DR750 

UETMA7800.EXE MA780 


UETUNASO00.EXE Ethernet Adapters 


9.6.3 System Load Test Phase 


The purpose of the system load test is to simulate a number of terminal 
users who are demanding system resources simultaneously. The system 
load tests, directed by the file VDETLOADO00.DAT, create a number of 
detached processes that execute various command procedures. Each 
process simulates a user logged in at a terminal; the commands within 
each procedure are the same types of commands that a user enters 

from a terminal. The load test creates the detached processes in quick 
succession, and the processes generally execute their command procedures 
simultaneously. The effect on the system is analogous to an equal number 
of users concurrently issuing commands from terminals. In this way, the 
load test creates an environment that is similar to normal system use. 
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The load test uses the logical name LOADS to determine the number of 
detached processes to create. When you initiate the UETP command 
procedure, it prompts for the number of users to be simulated (see 
Section 9.4.3) and consequently the number of detached processes to 

be created. Your response, which depends on the amount of memory and 
the swapping and paging space in your system, defines the group logical 
name LOADS. | | | 


The UETP master command procedure deassigns all group logical names 
assigned by its tests as part of the termination phase. The group logical 
name LOADS remains assigned only if the UETP package does not 
complete normally. 


The command procedures executed by the load test can generate a large 
amount of output, depending on the number of detached processes created. 
For each detached process (or user), the test creates a version of an 
output file called UETLOnnnn.LOG (“nnnn” represents a string of numeric 
characters). The console displays only status information as the load test 
progresses. 


Whether the load test runs as part of the entire UETP or as an individual 
phase, UETP combines the UETLOnnnn.LOG files, writes the output to 
the file DETP.LOG, and deletes the individual output files. 


You can run the system load test as a single phase by selecting LOAD 
from the choices offered in the startup dialog (see Section 9.4.1). 


9.6.4 DECnet Test Phase 
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9.6.4.1 


If DECnet is included in your VMS system, a run of the entire 

UETP automatically tests DECnet hardware and software. Because 
communications devices are allocated to DECnet and the DECnet devices 
cannot be tested by the UETP device test, UETP will not test the Ethernet 
adapter if DECnet or another application has allocated the device. The 
DECnet node and circuit counters are zeroed at the beginning of the 
DECnet test to allow for failure monitoring during the run. 


As with other UETP phases, you can run the DECnet phase individually 


by following the procedure described in Section 9.4.1. 


Environment 

The DECnet test will work successfully on VMS systems connected to all 
DECnet-supported node types, including routing and nonrouting nodes and 
several different types of operating systems (such as RSTS, RSX, TOPS, 
and RT). There must be some sort of default access on remote systems to 
copy files between systems. The DECnet phase tests the following: 


e The node UETP is running on 

e All circuits in sequence | 

e¢ All adjacent or first-hop nodes and all circuits in parallel 

There is no limit on the number of communication lines supported by the 


tests. A test on one adjacent node should last no more than two minutes 
at normal communications transfer rates. 


9.6.4.2, 
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How the DECnet Phase Works 

UETP (under the control of UETPHAS00.EXE) reads the file 
UETDNET00.DAT and completes the following steps during the DECnet 
phase: 


1 


Note: 


Executes a set of Network Control Program (NCP) LOOP EXECUTOR 
commands to test the node on which UETP is running. 


Uses NCP to execute the command SHOW ACTIVE CIRCUITS. The 
results are placed in UETININET.TMP, from which UETP creates 
the data file UETININET.DAT. The UETININET.TMP file contains 
the following information for any circuit in the ON state but not in 
transition: — 


e Circuit name 
e Node address 
e Node name (if one exists) 


The UETININETTMP file is used throughout the DECnet phase to 
determine which devices to test. 


Uses the UETININET:TMP file to create an NCP command procedure 
for each testable circuit. Each command procedure contains a set of 
NCP commands to zero the circuit and node counters and to test the 
circuit and adjacent node by copying files back and forth. 


If you do not want the counters zeroed, do not test DECnet. 


Executes the command procedures from step 3 in parallel to simulate a 
heavy user load. The simulated user load is the lesser of the following 
values: 


e The number of testable circuits, multiplied by two 


¢ The maximum number of user-detached processes that can be 
created on the system before it runs out of resources (determined 
by UETINIT00) 


Executes a program, UETNETS00.EXE, that uses the 


UETININET.DAT file to check the circuit and node counters for 

each testable circuit. If a counter indicates possible degradation 

(by being nonzero), its name and value are reported to the console. All 
counters are reported in the log file, but only the counters that indicate 
degradation are reported to the console. Following is an example of 
UETNETSO00 output: 


SUETP-S-BEGIN, UETNETSOO beginning at 19-APR-1990 13:45:33.18 
Circuit DMC-0 to (NODENAME1) OK. 
(NODENAME2) over DMC-1 response timeouts = 


SUETP-W-TEXT, 
SUETP-I-TEXT, 
SUETP-I-TEXT, 
SUETP-I-TEXT, 


Node 


Node 


dick 
Circuit DMC-1 to (NODENAME2) local buffer errors = 34. 
3 


(NODENAME3) over DMP-O response timeouts = 
SUETP-S-ENDED, UETNETSOO ended at 19-APR-1990 13:45:36.34 


Because degradation is not necessarily an error, the test’s success is 
determined by you, not the system. The following counters indicate 
possible degradation: 
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For Circuits 


®e 


Arriving congestion loss 
Corruption loss 
Transit congestion loss 
Line down 
Initialization failure 
Data errors inbound 
Data errors outbound | 
Remote reply timeouts 
Local reply timeouts 
Remote buffer errors 
Local buffer errors 
Selection timeouts 
Remote process errors 
Local process errors 
Locally initiated resets 


Network initiated resets 


For Nodes 


Response timeouts 

Received connect resource errors 
Aged packet loss 

Node unreachable packet loss 
Node out of range packet loss 
Oversized packet loss 

Packet format error 

Partial routing update loss 


Verification reject 


Cluster-Integration Test Phase 


The cluster-integration test phase consists of a single program and a 

command file that depend heavily on DECnet. This phase uses DECnet 
to create SYSTEST_CLIG processes on each VMS node in the cluster and 
to communicate with each node. SYSTEST_CLIG is an account that is 
parallel to SYSTEST, but limited so that it can only be used as part of the 
cluster-integration test. The following restrictions on the SYSTEST_CLIG 
account are necessary for a correct run of the cluster test phase: 
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¢ The account must be enabled and the password must be null. For 
more information, see Section 9.3.13. 


¢ The UIC must be the same as that of the SYSTEST account. 


e The account must have the same privileges and quotas:as the 
SYSTEST account. For more information, see Section 9.5.4.1. 


e The account can allow login only through DECnet. 


e The account must be locked into running UETCLIGO0.COM when it 
logs in. 


These items are necessary to ensure the security and privacy of your 
system. If the test cannot create a SYSTEST_CLIG process on some VMS 
node, it gives the reason for the failure and ignores that node for the lock 
tests and for sharing access during the file test. Also, the test does not 
copy log files from any node on which it could not create the SYSTEST_ 
CLIG process. If there is a problem communicating with a SYSTEST_ 
CLIG process after the process has been created, the test excludes it from 
further lock and file sharing tests. At the end of the cluster-integration 
test, an attempt is made to report any errors seen by that node. 


UETCLIG00.EXE has two threads of execution: the primary and the 
secondary. The first, or primary thread, checks the cluster configuration 
(VMS nodes, HSC nodes, and the attached disks that are available to 
the node running the test). For selected VMS nodes, the primary thread 
attempts to start up a SYSTEST_CLIG process through DECnet. If the 
primary thread was able to start a SYSTEST_CLIG process on a node, 
the node runs the command file UETCLIGO0.COM, which starts up 
UETCLIGO0.EXE and runs the secondary execution thread. 


The process running the primary thread checks to see that it can 
communicate with the processes running the secondary threads. It then 
instructs them to take out locks so that a deadlock situation is created. 


The primary thread tries to create a file on some disk on selected VMS 
and HSC nodes in the cluster. The primary thread writes a block, reads it 
back, and verifies it. The primary thread selects one VMS node at random 
and asks that node to read the block and verify it. The primary extends 
the file by writing another block and has the secondary read and verify the 
second block. The file is deleted. 


The secondary processes exit. They copy to the primary process the 
contents of their SYS$ERROR files, so that the UETP log file and console 
report show all problems in a central place. DECnet automatically creates 
a NETSERVER.LOG in SYS$TEST as the test is run, so that if necessary, 
you can read that file later from the node in question. _ 


During the test run, the primary process uses the system service 
SYS$BRKTHRU to announce the beginning and ending of the test to 
each VMS node’s console terminal. 


You can define the group logical name MODE to the equivalence string 
DUMP to trace most events as they occur. Note that the logical name 
definitions apply only to the node on which they were defined. You must 
define MODE on each system in the VAXcluster on which you want to 
trace events. 
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Booting from [SYSF] During an Upgrade 


This appendix describes how to boot the various VAX computers from 
[SYSF]. You must boot from the [SYSF] root during phase 2, 3, and 4 of 
the upgrade procedure. 


A.1 MicroVAX and VAXstation Computers 


The information in this section applies to the following VAX computers: 


VAXstation II, VAXstation II/GPX, and MicroVAX II 
VAXstation 2000 and MicroVAX 2000 

VAXstation 3100 

VAXstation 3520 and 3540 

MicroVAX 3400 and MicroVAX 3600 

VAX 6000 Series 

VAXstation 8000 


To boot from [SYSF], enter the BOOT command in the following format 
and press RETURN: 


>>> B/FOO00000 device-name 


Substitute the device name of the system disk for device-name. 


A.2 VAX 8530, 8550, 8700, 8810-N, 8820, 8830, and 8840 
| To boot from [SYSF], use the following procedure: 


1 


Press CTRL/P. On the VAX 8530, enter the following command at the 
console-mode prompt (>>>) and press RETURN: 


>>> HALT 


On the VAX 8820, enter the following command at the PS-OS-0> 
prompt and press RETURN: 


PS-OS-0> HALT/CPU=ALL 


On the VAX 8530, enter the BOOT command at the console-mode 
prompt (>>>) in the following format: 


>>> B dddn /R5:F0000000 


Substitute BCI, BDA, or UDA for ddd. Substitute the unit number of 
the drive holding the system disk for n. 


On the VAX 8820, enter the BOOT command at the PS-CIO-0> prompt 
in the following format: 


PS-CIO-O> B dddn /R5=F0000000 


Substitute BCI or BDA for ddd. Substitute the unit number of the 
drive holding the system disk for n. 
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VAX 11/750, VAX 8200, 8250, 8300, and 8350 
To boot from [SYSF], create a command procedure named SYFBOO.CMD. 
To create SYFBOO.CMD, use the following procedure: 


Note: This procedure assumes that you have installed and booted the 
VMS operating system and are logged into the SYSTEM account. 


1 Make sure that the console media is in the console drive. 


2 To connect the console drive to the system, enter the following 
commands and press RETURN after each one: 


$ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


3 Use the Exchange Utility to copy the appropriate boot command 
procedure from the console media to your current directory on the 
system disk. If the system disk is on an HSC drive and you have 
created DEFBOO.CMD, enter the following command and press 
RETURN: 


$ EXCHANGE COPY CSA1:DEFBOO.CMD 

On the VAX 11/750, if the system disk is on a local drive, copy the 
boot command procedure that matches the drive that holds the system 
disk. For example, suppose the system disk is on an RPO6 drive and 


has a controller designation of A and a unit number of one. Enter the 
following command and press RETURN: 


$ EXCHANGE COPY CSA1:DA1BOO.CMD 


4 Edit the boot command procedure. Change the line that deposits a 
value in register 5 (R5). This line contains the comment /software 
boot flags. The value is a hexadecimal number with eight digits. For 
example: 


D/G R5 0 'software boot flags 


_ Change the left-most digit of the value to reflect the name of the root 
directory from which you want to boot. For example, to boot from the 
[SYSF] root directory, change the line as follows: 


D/G/L R5 FOO00000 !'designated root is SYSF 


5 Rename the boot command procedure to SYFBOO.CMD. For example, 
if the boot command procedure is DEFBOO.CMD, enter the following 
command and press RETURN: 


$ RENAME DEFBOO.CMD SYFBOO.CMD 


6 Use the Exchange Utility to copy SYFBOO.CMD back to the console 
media. Enter the following command and press RETURN: 


$ EXCHANGE COPY SYFBOO.CMD CSA1:SYFBOO.CMD 


7 When you are finished, enter the following command and press 
RETURN: 


§ DISMOUNT CSA1 
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8 To secure the console media from unauthorized access, you must enter 


the following command and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA1 


To boot from [SYSF], use the following procedure: 


1 


Make sure the console media is in the console drive. On the VAX 
11/750, make sure the keylock switch is set to LOCAL. Set the BOOT 
DEVICE switch to position A. 


On the VAX 8200, set the upper keylock switch to ENABLE and the 
lower keylock switch to HALT. 


2 Press CTRL/P. 


On the VAX 11/750, enter the following command and press RETURN: 
>>> B/800 DDAO 


On the VAX 8200, enter the following command at the console-mode 
prompt (>>>) and press RETURN: 


>>> B/R5:800 CSA1 
At the BOOT58> prompt, enter the following command: 


BOOT58> @SYFBOO.CMD 


A.4 VAX 11/730, VAX 11/780, VAX 8600, and VAX 8650 


To boot from [SYSF], create a command procedure named SYFBOO.CMD 
(for VAX 11/730 and VAX 11/780) or SYFBOO.COM (for VAX 8600 and 
VAX 8650). 


To create SYFBOO.CMD or SYFBOO.COM, use the following procedure: 


1 


Make sure that the console media is in the console drive. On the VAX 
8600, make sure the TERMINAL CONTROL switch is set to LOCAL. 


Log into the SYSTEM account. 


To connect the console drive, enter the following commands and press 
RETURN after each one: 


S$ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


Use the Exchange Utility to copy DEFBOO.CMD (for VAX 730 and 
VAX 780) or DEFBOO.COM (for VAX 8600 and VAX 8650) from the 
console media to your current directory on the system disk. On the 
VAX 11/780 and VAX 8600, enter a command similar to the following 
and press RETURN: 


$ EXCHANGE COPY CSA1:DEFBOO.CMD * 
On the VAX 11/730, enter the following command and press RETURN: 


S EXCHANGE COPY CSA2:DEFBOO.CMD * 
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5 Edit DEFBOO.CMD or DEFBOO.COM. Change the line that deposits 
a value in register 5 (R5). On the VAX 11/730 and VAX 11/780, this 
line contains the comment /software boot flags. On the VAX 8600, 
this line contains the comment /Use Rd for optional boot control flags 
[SYSB.]. The value is a hexadecimal number with eight bits. For 
example: ; 


DEPOSIT R5 10000000 ‘software boot flags 


Change the left-most digit of the value to reflect the name of the root 
directory from which you want to boot. For example, to boot from 
[SYSF], change the line as follows: 


DEPOSIT R5 FOQO00000 'software boot flags 


6 Rename DEFBOO.CMD to SYFBOO.CMD (or DEFBOO.COM to 
SYFBOO.COM), as follows: 


S$ RENAME DEFBOO.CMD SYFBOO.CMD 


7 Use the Exchange Utility to copy SYFBOO.CMD or SYFBOO.COM to 
the console media. Enter a command similar to the following: 


S$ EXCHANGE COPY SYFBOO.CMD CSA1:SYFBOO.CMD 


For example, on the VAX 11/730 enter the following command and 
press RETURN: 


S$ EXCHANGE COPY SYFBOO.CMD CSA2:SYFBOO.CMD 


8 When you are finished, enter a command similar to the following and 
press RETURN: 


S$ DISMOUNT CSAl1 


9 To secure the console media from unauthorized access, you must enter 
a command similar to the following and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA1 


To boot from [SYSF] during an upgrade, use the following procedure: 


1 Make sure the console media is in the console drive. On the VAX 
11/730 and the VAX 11/780, make sure the keylock switch is set to 
LOCAL. On the VAX 8600, make sure the TERMINAL CONTROL 
switch is set to LOCAL. 


2 Press CTRL/P. On the VAX 780 and VAX 8600, enter the HALT 
command at the console-mode prompt (>>>) and press RETURN: 


>>> HALT 


3 Use SYFBOO.CMD to boot from [SYSF]. Enter the following command 
and press RETURN: 


PPP BD OLE 


A.5 VAX 6000 Series 


ne from [SYSF] During an Upgrade 
A.5 VAX 6000 Series 


To boot from [SYSF], use the following procedure: 


1 


If you have a CIBCA-A adapter and are booting over the Cl, insert the 
console tape cartridge in the console drive. 


Press CTRL/P to put the system in console mode. 

Enter the BOOT command in the following format: 

>>> BOOT /R5:FO000000 /XMI:a /BI:b [/R3:c] [/NODE:d] DUu 
where: 

¢ ais the XMI node number of the system disk. 

¢ 6 is the VAXBI node number of the system disk. 


¢ ¢ pertains to Volume Shadowing. This qualifier is not required 
unless you are using Volume Shadowing. For more information, 
see the VAX Volume Shadowing Manual. 


¢ dis the HSC node number of the node being accessed. The /NODE 
qualifier is not necessary if you are booting from a local disk. The 
HSC node number is in hexadecimal. You can deposit a maximum 
of two HSC node numbers (if two HSCs are available). 


¢ wis the unit number of the drive holding the system disk. 


For example, suppose you want to boot from [SYSF] on an HSC 
disk with a unit number of one and your system has the following 
configuration: 


¢ The disk is connected to the VAXBI at node 2 

¢ The VAXBI you are using is connected to the XMI at node 3. 
e The disk is available to two HSCs, node numbers OE and 02. 
Enter the following command and press RETURN: 


22> BOOT/R5:F0000000/XMI:3/BI:2/NODE:0E02 DU1 


B 


DECwindows Logical Names 


After you start DECwindows, a system-wide logical name table is created 
and is added to the default logical name table search lists. Table B-1 lists 
the logical names contained in this table. 


Table B-1 DECW$LOGICAL_NAMES 


Logical Name 


CDA$LIBRARY 
DECW$BOOK 
DECWS$EXAMPLES 
DECW$INCLUDE 


DECWSKEYMAP 
DECWSSERVER_TRANSPORTS 


DECWSSTARTVUECOM 
DECW$SYSTEM_DEFAULTS 


DECW$USER_DEFAULTS 
DECWS$WINMGREXE 


DECW$XLIBERRDB 
VUES$LIBRARY 


Definition 


DDIF document style guide. 
Online documentation. 
DECwindows example files directory. 


DECwindows MIT-compatible C language 
include files. 


DECwindows keyboard map definitions 
directory used by the Session Manager. 


A list of transport types that the DECwindows 
server will load when it starts up. 


Startup file for FileView. 


The system-wide directory where DECwindows 
application will look for resource files. 


The user directory where DECwindows 
applications will look for resource files. 


Window manager executable file used by the 
Session Manager. 


Pointer to the Xlib error resource database. 


Directory containing FileView command files 
and the FileView default system profile. 


After you start the server, a per-server logical name table is created on 
your system but is not added to the default logical name table search lists. 


Table B—2 lists the logical names. 


Table B-2. DECW$SERVER(n)_TABLE 


Logical Name 


DECW$COLOR 


DECW$DEFAULT_FONT 


Definition 


Determines whether the server will consider a 
VAXstation/GPX to be color or intensity. 
Determines the font which is initially loaded in 
a graphics context. 
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Table B-2 (Cont.) DECW$SERVER(n)_ TABLE 


Logical Name 


DECW$DEFAULT_KEYBOARD_ 
MAP 


DECWS$FONT 
DECW$KEYBOARD 
DECWSKEYMAP 


DECWS$MONITOR_DENSITY 


DECW$POINTER 
DECW$RGB_* 


DECW$SERVER_DISABLE_CH 


DECWS$SERVER_SCREENS 


DECWS$XSIZE_IN_PIXELS 
DECWSYSIZE_IN_PIXELS 


Definition 

Determines which keyboard map file the 
server uses. 

Directory where the server will look for fonts. 
Device name for system keyboard. 


DECwindows keyboard map definitions 
directory used by the server. 


Determines what monitor density the server 
will use to calculate the monitor size. 
Device name for system pointer. 

Definitions of color names used by the 


XStoreNamedColor and XAllocNamedColor 
requesis. 


lf defined to be true, server exception will 
cause the server to crash and produce a dump 
file, rather than attempt to continue. 


Device name used by the server. The first 
two characters indicate the shareable image 
to be loaded for device support (for example, 
GCAO:). | 


Specifies the size of the workstation screen. 
Specifies the size of the workstation screen. 


Note: These logical names may change in a future release. 
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The print dialog box is used in many applications for the queueing of files 


or screens to a printer. (See the VMS DECwindows User’s Guide for more 
information about the print dialog box.) By default, all printing devices 
on the system are displayed in the “Printers” listbox. However, you can 
take advantage of a feature where print queues can be associated with 
print formats through the definition of logical names. The logical name is 
defined to be a comma-separated or space-separated list of print queues 
with the first queue being the default choice. 


For example, if DECW$PRINTER_FORMAT_ANSI2 is defined to be “MY_ 
PRINTER, CLUSTER_LN03, ANOTHER_LNO3”, when you select “ANSI2” 


from the print format listbox, only MY_PRINTER, CLUSTER_LNO38, and 


ANOTHER_LN0O3 will be shown in the printer listbox, with MY_PRINTER 
being the default choice. 


Table B—3 lists the logical names and the print formats associated with 
each. 
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Table B-3 Print Dialog Box Logical Names 


Logical name Print format 
DECW$PRINTER_FORMAT_TEXT Text 
DECWS$PRINTER_FORMAT_LINE Line Printer 
DECW$PRINTER_FORMAT_TERM Terminal 
DECW$PRINTER_FORMAT_ANSI2 ANSI2 
DECW$PRINTER_FORMAT_ANSI ANSI 
DECW$PRINTER_FORMAT_REGIS ReGlS 
DECWS$PRINTER_FORMAT_TEK Tektronix 
DECW$PRINTER_FORMAT_DDFF DDFF 
DECW$PRINTER_FORMAT_DDIF DDIF 


The logical names can be defined by system managers in the appropriate 
logical name tables and be overridden by users. 


If you have any of the logical names in Table B—3 defined in your 
environment, they will serve as the list of printer queue names to be 
presented when the corresponding print format is selected. This method is 
much faster than making the print dialog box derive the names of all the 
queues on the system, most of which are inappropriate for the print format 
under consideration, as the following example shows: 


$ define DECWSPRINTER FORMAT TEXT "CLUSTER_LNO3,CLUSTER_ PRINT, - 
_$ ANSI_ARTWRK,ANSI_ PROTON" 
$ define DECWSPRINTER_ FORMAT LINE "CLUSTER_PRINT" 
$ define DECWSPRINTER_FORMAT ANSI2 "CLUSTER_LNO3,ANSI_ARTWRK,ANSI_PROTON" 
$ define DECWSPRINTER_ FORMAT ANSI "CLUSTER_LNO3,ANSI_ARTWRK,ANSI_PROTON" 
$ define DECWSPRINTER_ FORMAT PS "PS ARTWRK,PS PROTON" 
~$ define DECWSPRINTER_ FORMAT REGIS "SYSSNULL" 





B.2 $Server Startup Command Procedures 


The startup command procedures automatically determine most of the 
configuration variables for the DECwindows server. However, there are 
two items which the command procedures cannot determine: 


1 Ifyou have a VAXstation 2000/GPX, a VAXstation 3xxx/GPX, or a 


VAXstation II/GPX, the startup procedures assume that you have a 
color monitor. 


2 The startup procedures assume that you have a North American 


keyboard layout (you have an LK201-AA or -LA keyboard). 


If either of these assumptions is incorrect, you must override them as 
follows: 


¢ Make a copy of the file SYSSMANAGER:DECW$PRIVATE_SERVER_ 
SETUP.TEMPLATE and rename it *.COM. This file shows how 
to customize individual workstations by adding a section of DCL 
commands for each workstation. The section for monochrome /GPX 
workstations should contain the following line: 
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S$ DECWSCOLOR == "FALSE" 


The section for workstations with keyboards that are not North 
American should contain the following line: 


$ DECWSDEFAULT KEYMAP == "xxxxx" 


e In the previous line, you must replace “xxxxxx” with the correct 
DECwindows keymap name. You can determine the correct name from 
the model number of your LK201 keyboard. Turn the keyboard upside 
down, and look for a label which specifies the model number. The 
model number should be in a format similar to LK201-xx. The model 
number may also be listed as simply LK201. In this case, the “xx” that 
you need is in another part of the label where there will be a number 
that looks similar to the following: 


| ANTNNNNMNTXX. 


¢ Use the xx part of this number to choose a keymap name from the 
following table. The table is arranged based on the dialect that each 
keyboard is designed for. Choose the keymap ending in _DP for the 
data processing keyboard layout, or the keymap ending in _T'W for the 


typewriter layout. 


Table B-4 DECwindows Keymap 


Dialect 


Austrian/German 


Belgian/French 
British 
Canadian/French 


Danish 


Dutch 


Finnish 
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Model 
LK201-(AG,LG,BG,MG) 


-LK201-(NG,PG) 


LK201-(AP,LP.BP.MP) 


LK201-(AE,LE,BE,ME) 
LK201-(AC,LC,BC,MC) 
LK201-(AD,LD,BD,MD) 
LK201-(ED,RD,FD) 

LK201-(AH,LH,BH,MH) 


LK201-(NH,PH) 
LK201-(AF,LE.BF.MF) 
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AUSTRIAN_GERMAN_LK201LG_DP 
AUSTRIAN_GERMAN_LK201LG_TW 
AUSTRIAN_GERMAN_LK201NG_DP 
AUSTRIAN _GERMAN_LK201NG_TW 
BELGIAN_FRENCH_LK201LP_DP 
BELGIAN_FRENCH_LK201LP_TW 


BRITISH _LK201LE_DP 
BRITISH_LK201LE_TW 


CANADIAN_FRENCH_LK201LC_DP 
CANADIAN_FRENCH_LK201LC_TW 


DANISH_LK201LD_DP 
DANISH_LK201LD_ TW 
DANISH_LK201RD_DP 
DANISH_LK201RD_TW 
DUTCH_LK201LH_DP 
DUTCH_LK201LH_ TW 
DUTCH_LK201NH 
FINNISH_LK201LF_DP 
FINNISH_LK201LF_TW 
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Table B—4 (Cont.) DECwindows Keymap 


Dialect Model DECwindows Keymap 
LK201-(NF,PF) FINNISH_LK201NF_DP 
FINNISH_LK201NF_TW 
LK201-(NX,PX) FINNISH_LK201NX_DP 
FINNISH_LK201NX_TW 
Flemish LK201-(AB,LB,BB,MB) FLEMISH_LK201LB_DP 
FLEMISH_LK201LB_TW 
Icelandic LK201-(AU,LU,BU,MU) ICELANDIC_LK201LU_DP 
ICELANDIC_LK201LU_TW 
Italian LK201-(AI,L!,Bi,Ml) ITALIAN LK201L1_ DP 
ITALIAN _LK201LI_TW 
North American LK201-(AA,LA,BA,MA) NORTH_AMERICAN_LK201LA 
Norwegian LK201-(AN,LN,BN,MN) NORWEGIAN_LK201LN_DP 
NORWEGIAN_LK201LN_TW 
LK201-(EN,RN,FN) NORWEGIAN_LK201RN_DP 
NORWEGIAN_LK201RN_TW 
Portuguese LK201-(AV,LV,BV,MV) PORTUGUESE_LK201LV 
Spanish LK201-(AS,LS,BS,MS) SPANISH_LK201LS_DP 
SPANISH_LK201LS_TW 
Swedish LK201-(AM,LM,BM,MM) SWEDISH_LK201LM_DP 
SWEDISH_LK201LM_TW 
LK201-(NM,PM) SWEDISH_LK201NM_DP 
SWEDISH_LK201NM_TW 
Swiss/French LK201-(AK,LK,BK,Mk) SWISS_FRENCH_LK201LK_DP 
SWISS_FRENCH_LK201LK_TW 
Swiss/German LK201-(AL,LL,BL,ML) SWISS_GERMAN_LK201LL_DP 
SWISS_GERMAN_LK201LL_TW 
Combined US/UK LK201-(EE,RE,PE) UK_LK201RE 
US_LK201RE 
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C Files in the VMS Library and Optional Save Sets 


This appendix lists the files in the VMS library and optional save sets. 
VMS Library 


Accounting Log Report Generator Utility 
Analyze Object File Utility (ANALYZE/OBJECT) 
Debugger Utility (DEBUG) 

Delta debugger 

DUMP 

EDT documentation 

Error Log Report Generator Utility (ANALYZE/ERROR) 
File Access Control List Utilities 

Files-11 ODS1 ACP 

Foreign Terminal support 

FORTRAN require files 

Image Dump Utility (ANALYZE/AAMAGE) 
Incoming Remote File Access files 
Incoming Remote Terminal files 

Input Queue Symbiont (Card Reader) 
LAT-11 terminal server (via Ethernet) 
MACRO Assembler 

MACRO Libraries 

MAIL 

Message Utility (MESSAGE) 

Monitor Utility 

National Character Set Utility (NCS) 
Network support 

Network Test files 

Object and Shareable Image libraries 
PHONE 

Print and Batch Queue Utilities 
Programming Support 

Remote Task Loading 

RMS Analyze and FDL Editor Utilities (ANALYZE/RMS, 
ANALYZE/FDL) 

RMS Journaling files 

RUNOFF 

SDL intérmediary form of STARLET.MLB 
Secure User’s Environment 

Standalone BACKUP 

System Dump Analyzer Utility (ANALYZE/SYSTEM, 
ANALYZE/CRASH) 

System programming Support 

System Symbol Table file (SYS.STB) 
TECO editor 


C1 
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Terminal Fallback Facility 
VAX-C object libraries 

VAXTPU 

VMS HELP library 

VMS workstation support 

VMS workstation device support 


VMS Optional 


BLISS require files 

Example files 

Files for VMS development only 

Files used for kitting 

LPA-11 support 

Miscellaneous files 

Miscellaneous Symbol Table files 
System map 

User Environment Test Package (UETP) 


[) DECwindows Software Components Table 


Table D-1 contains the name of each VMS DECwindows software 
component, the directory where the component can be found, a brief 
description of what the component does, and one of the following three 
component classifications: 


¢ ALL—Indicates that the component is part of all installations. 
¢ PROG—Indicates the component is part of the programming 


Table D-1 DECwindows Software Components 


Component 
Directory File Purpose Class 
CDA$LIBRARY DEFSTYLE.DDIF DDIF document style guide PROG 
DECWS$EXAMPLES DEMO_BUILD.COM Procedure to compile demo PROG 
sources 
ALLOBJS.H Demo Source PROG 
BITMAP.C Demo Source PROG 
BITMAP.EXE Demo Source PROG 
CLOCK.DDIF Paint example ALL 
DECBURGER.C . UIL DRM Demo souce PROG 
DECBURGER.COM UIL DRM Demo file PROG 
DECBURGER.UID UIL DRM Demo file PROG 
DECBURGER.UIL UIL DRM Demo file PROG 
DECBURGER.ADA UIL DRM Demo source PROG 
DECBURGER.EXE Demo image PROG 
DIALOG.C Demo Source PROG 
DWTVMSPUSHTEST.B32 XUI toolkit demo PROG 
DWTVMSPUSHTEST.EXE Demo image PROG 
HELLOWORLD.ADA Demo source PROG 
HELLOWORLD.C XUI toolkit demo PROG 
HELLOWORLD.UID Demo file PROG 
HELLOWORLD.UIL Demo file PROG 
HELLOWORLD.EXE Demo image PROG 
ICO.C Demo source PROG 


environment. 


¢ WS—lIndicates that the component is part of the workstation device 


support. 
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Table D-1 (Cont.) DECwindows Software Components 


Directory 


DECWS$FONT: 


- DECWSINCLUDE 





D~2 


File 


ICO.EXE 
ICOPAS.PAS 
OBJCUBE.H 
OBJICO.H 
OBJTETRA.H 
PLAID.C 
PLAID.EXE 
POLYINFO.H 
STRINGS.MAR 


XLIBINTRO.ADA 
XLIBINTRO.C 

XLIBINTRO.FOR 
XLIBINTRO.EXE 


see VMS DECwindows Xlib 
Programming Volume 


COMPOB4J.H 
COMPOBUP.H 


COMPOSITE.H 


CONSTRAINT.H 
CONSTRAINP.H 
CONVERT.H 
CORE.H 
COREP.H 


CURSORFONT.H 


Purpose 


Demo image 
Demo source 
Demo source 
Demo source 
Demo source 
Demo source 
Demo image 
Demo source 


Low-level DECwindows utility 
routine 


Demo source 
Demo source 
Demo source | 
Demo source 


DECwindows fonts 


Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 
Xlib and XU! toolkit 
programming include files 
Xtio and XU! toolkit 


programming include files 


Xlib and XU! toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XU! toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 
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Component 


Class 


PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 


PROG 
PROG 
PROG 
PROG 


WS 


PROG 


PROG 


PROG 


DECwindows Software Components Table 


Table D-1 (Cont.) DECwindows Software Components 


Component 

Directory File Purpose Class 

DECWDWTAPPLPROG.H Xlio and XUI toolkit PROG 
programming include files 

DECWDWTAPPLPROG.UIL XUI toolkit support PROG 

DECWDWTWIDGETPROG.H Xlib and XUI toolkit PROG 
programming include files 

DECWMHINTS.H Xlib and XUI toolkit PROG 
programming include files 

DWTAPPL.H Xlib and XUI toolkit PROG 
programming include files 

DWTAPPL.UIL Xlib and XUI toolkit PROG 
programming include files 

DWTWIDGET.H Xlib and XUI toolkit PROG 
programming include files 

EVENT.H Xlib and XUI toolkit PROG 
programming include files 

INTRINSIC.H Xlib and XUI toolkit PROG 
programming include files 

INTRINSICP.H Xlib and XUI toolkit PROG 
programming include files 

KEYSYM.H Xlib and XUI toolkit PROG 
programming include files 

KEYSYMDEF.H Xlib and XUI toolkit PROG 
programming include files 

OBJECT.H Xlib and XUI toolkit PROG 
programming include files 

OBJECTP.H Xlib and XUI toolkit PROG 
programming include files 

RECTOBJ.H Xlib and XUI toolkit PROG 
programming include files 

RECTOBJP.H Xlib and XUI toolkit PROG 
programming include files 

SELECTION.H Xlib and XUI toolkit PROG 
programming include files 

SHELL.H Xlib and XUI toolkit PROG 
programming include files 

SHELLP.H Xlidb and XU! toolkit PROG 
programming include files 

STRINGDEFS.H Xlib and XUI toolkit PROG 
programming include files 

TRANSLATE.H Xlib and XUI toolkit PROG 


programming include files 
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Table D~-1 (Cont.) DECwindows Software Components 


Directory 


SYS$LIBRARY: 


File 
VENDOR.H 


VENDORP.H 
WINDOWOBJ.H 
WINDOWOBUJP.H 
X.H 

XATOM.H 
XLIB.H 

XMD.H 

XOS.H 
XPROTO.H 
XPROTOSTR.H 
XRESOURCE.H 


XUTIL.H 


CDA$ACCESS.EXE 


CDA$CDA_.ADA 
CDA$DEF.*' 


CDA$MSG.*" 


CDASWRITE_ANALYSIS.EXE 


DDIFSDDIF_.ADA 
DDIF$DEF.*" 


DDIF$READ_TEXT.EXE 


Purpose 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlidb and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XU! toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


The DDIF toolkit and DDIF 
converter toolkit Run-time- 
library shareable image 


CDA Ada binding 

DDIF converter language 
binding 

DDIF message symbols 
CDA image 

DDIF Ada binding 

DDIF language binding 


Text front end shareable 
image 


Component 
Class 


PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 


PROG 


PROG 


PROG 
PROG 


PROG 
ALL 
PROG 
PROG 
ALL 





‘Asterisk (*) indicates that BASIC, BLISS, FORTRAN, C, Macro, Pascal, and PLI languages are supported. 
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Table D-1 (Cont.) DECwindows Software Components 


Directory 


File 
DDIFSSTROKE_FONT*.DAT 


DDIF$VIEW.UID 
DDIF$VIEWSHR.EXE 
DDIFSWRITE_PS.EXE 
DDIFSWRITE_TEXT.EXE 


DECW$CALC.DAT 
DECWS$CALC.UID 
DECW$CALENDAR.DAT 
DECWS$CARDFILER.DAT 
DECW$CARDFILER.UID 
DECW$CLOCK.DAT 
DECW$CLOCK.UID 
DECW$CURSOR.H 
DECW$DWT_.ADA 
DECW$DWTDEF.** 
DECWS$DWTDEF.UIL 
DECW$DWTLIBSHR.EXE 
DECWS$DWTWIDGETDEF.*' 
DECW$LOGIN.DAT 
DECW$LOGINOUT.EXE 


DECWS$MAIL.DAT 
DECWS$MAILSHR.EXE 


DECW$NOTEPAD.DAT 
DECWS$PAINT.DAT 


DECW$PRINTWGT.UID 
DECW$PUZZLE.DAT 
DECW$PUZZLE.UID 
DECW$SERVER_DDX_GA.EXE 


DECWS$SERVER_DDX_GC.EXE 


Purpose 


Fonts for use by DDIF 
viewers 


Viewer support file 
DDIF viewer shareable image 
Text image 


Text back end shareable 
image 


Calculator support file 
Calculator support file 
Calendar support file 
Cardfiler support file 
Cardfiler support file 
Clock support file 
Clock support file 
Cursor include files 
Toolkit Ada binding 
Widget include files 
Toolkit UIL definitions 
XUI toolkit shareable image 
Widget include files 
Login data file 


DECwindows extension to 
VMS loginout image 


DECwindows VMSmail 
support file 


DECwindows VMSmail 


shareable image 


NOTEPAD support file 
DECwindows Paint support 
file 

Print support file 

Puzzle support file 

Puzzle support file 


Server color device support 
shareable image 


Server monochrome device 
support shareable image 


Component 
Class 


ALL 


ALL 
ALL 
ALL 
ALL 


ALL 
ALL 
ALL | 
ALL 
ALL 
ALL 
ALL 


PROG 


PROG 
PROG 
PROG 
PROG 
PROG 
ALL 

ALL 


ALL 
ALL 


ALL 
ALL 


ALL 
ALL 
ALL 
WS 


ws 





‘Asterisk (*) indicates that BASIC, BLISS, FORTRAN, C, Macro, Pascal, and PLI languages are supported. 
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DECwindows Software Components Table 


Table D-1 (Cont.) 


DECwindows Software Components 








Component 
Directory File Purpose Class 
DECWSSERVER_DIX.EXE Server device independent WS 
support 
DECWS$SESSION.DAT Session manager support file ALL 
DECW$SM_BW.DAT Session manager support file ALL 
DECW$SM_COLOR.DAT Session manager support file ALL 
DECW$SM_GENERAL.DAT Session manager support file ALL 
DECW$SM_GRAY.DAT Session manager support file ALL 
DECWS$TERMINAL.DAT Terminal support file ALL 
DECWS$TERMINAL.UID Terminal support file ALL 
DECW$TERMINALSHR.EXE Terminal shareable image ALL 
DECWS$TRANSPORT_ Transport common shareable ALL 
COMMON.EXE image 
DECW$TRANSPORT_DECNET.EXE _ Transport DECnet-specific ALL 
image 
DECWS$TRANSPORT_LOCAL.EXE Transport local image ALL 
DECWS$UIL.ENV LSE template for VIL PROG 
compilier 
DECWSWINMGR. DAT Window manager support file = ALL 
DECWS$X_.ADA Xlib Ada binding PROG 
DECW$XLIBDEF.*' Language Xlib binding PROG 
DECWS$XLIBMSG.*' Language message symbols PROG 
DECW$XLIBSHR.EXE Xlib shareable image PROG 
VUE$DEFAULTS.DAT FileView defaults file ALL 
SYS$MANAGER: DECWSCHECK_PARAMS.COM Check autogen parameters ALL 
DECW$DEVICE.COM Device detection and ALL 
configuration 
DECW$LOGICALS.COM Logical name table ALL 
initialization and start 
DECWS$PRIVATE_SERVER_ Server customization WS 
SETUP.TEMPLATE template 
DECWS$RGB.COM Definitions of the color WS 
names used by the 
XStoreNamedColor and 
XAllocNamedColor requests 
DECW$STARTAPPS.COM User environment ALL 
DECWSSTARTLIBS.COM Programming environment PROG 


startup 





‘Asterisk (*) indicates that BASIC, BLISS, FORTRAN, C, Macro, Pascal, and PLI languages are supported. 
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Table D-1 (Cont.) DECwindows Software Components 


Directory 


SYSS$MESSAGE 


SYS$SYSTEM: 


File 
DECWS$STARTSERVER.COM 


DECW$STARTSM.COM 
DECWS$STARTUP.COM 


DECWS$STARTVUE.COM 
DECWS$SYLOGIN.COM 


DDIF$VIEWMSG.EXE 
DECW$DWTERRDB.EXE 


DECWSDWTMSG.EXE 
DECWS$MAIL_MESSAGES.EXE 
DECWSTRANSPORTMSG.EXE 
DECW$XLIBERRDB.DAT 
DECWS$XLIBMSG.EXE 


CDA$CONVERT.EXE 
DDIF$VIEW.EXE 
DECW$BOOKREADER.EXE 
DECW$CALC.EXE 
DECW$CALENDAR.EXE 
DECW$CARDFILER.EXE 
DECW$CLOCK.EXE 
DECW$FONTCOMPILER.EXE 
DECWS$MAIL.EXE 


DECWS$MAIL__ 
CREATEDECTERM.EXE 


DECW$MAIL_EDIT.COM 


DECW$NOTEPAD.EXE 
DECWSPAINT.EXE 
DECWS$PUZZLE.EXE 
DECWS$SERVER_MAIN.EXE 
DECW$SESSION.EXE 


Purpose 

Server initialization and 
startup 

Starts the session manager 


Starts the DECwindows 
environment 


Starts the FileView 
System login file 


Viewer message file 


DECwindows shareable 
image 


Toolkit message file 

Mail message file 
Transport message image 
Xlib resource database 
Message image 


DDIF converter image 
DDIF viewer 
Bookreader image 
Calculator 

Calendar 

Cardfiler 

Clock 

Font compiler 
DECwindows VMSmail 


DECwindows VMSmail 
support file 
DECwindows VMSmail 
suport file 

Notepad image 


Paint image 


Puzzle image 
Server main image 


Manages the session and 
contains the contro! panel 


Component 
Class 


WS 


ALL 
ALL 


ALL 
ALL 


ALL 
PROG 


PROG 
ALL 


ALL 


PROG 
PROG 


ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 


ALL 


ALL 


ALL 


ALL 
ALL 
ALL 
WS 
ALL 
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Table D-1 (Cont.) DECwindows Software Components 





Directory 


SYS$LOADABLE_ 


IMAGES: 


DECW$BOOK: 


DECWSKEYMAP: 


SYSSHELP: 


File 
DECWS$SETSHODIS.EXE 


DECW$STARTLOGIN.EXE 


DECWS$TERMINAL.EXE 
DECW$UILCOMPILER.EXE 
DECWS$WINMGR.EXE 


VUES$MASTER.EXE 
GAADRIVER.EXE 


GABDRIVER.EXE 
GCADRIVER.EXE 


GCBDRIVER.EXE 


IKDRIVER.EXE 
IMDRIVER.EXE 
INDRIVER.EXE 
PYDRIVER.EXE 
TWDRIVER.EXE 
WSDRIVER.EXE 


BOOKREADER.DECW$BOOK 


DDIFSVIEW.HLB 
DECWS$CALC.HLB 
DECW$CALENDAR.HLB 
DECW$CARDFILER.HLB 
DECW$CLOCK.HLB 
DECWS$HELPHELP.HLB 
DECWSMAIL.HLB 
DECWS$NOTEPAD.HLB 
DECWS$PAINT.HLB 


Purpose 


SET/SHOW DISPLAY 
command image 


Starts the DECwindows 
LOGINOUT.EXE image 


Terminal emulator controller 
UIL compiler 


DECwindows window 
manager 


FileView image 
VAXstation II/GPX driver 


VAXstation 2000/GPX driver 


VAXstation Il monochrome | 
device driver 


_VAXstation 2000 


monochrome device driver 
Keyboard decoder driver 
Mouse decoder driver 
Common input function driver 
Pseudo terminal driver 
Pseudo terminal driver 

Set display driver 


Online user’s guide for the 
Bookreader 


Paalbra 
Bookreader b 


DECwindows Keymap files 


View help file 
Calculator help file 
Calendar help file 
Cardfiler help file 
Clock help file 
HELP help file 
Mail help file 
Notepad help file 
Paint help file 


Component 
Class 


PROG 
ALL 


ALL 
PROG 
ALL 


ALL 
WS 


WS 
WS 


WS 


WS 
WS 
WS 
ALL 
ALL 
ALL 


ALL 


Al | 
F Uhre hee 


WS 


ALL 
ALL 
ALL 
ALL 
ALL 
PROG 
ALL 
ALL 
ALL 
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Directory File 
DECWS$PRINTWGT.HLB 
DECWS$PUZZLE.HLB 
DECWS$SESSION.HLB 
DECW$TERMINAL.HLB 
DECW$VUE.HLB 


SYS$UPDATE: DECWS$COMPILE_ADA_ 
UNITS.COM 
VUE$LIBRARY: VUE$*.COM 


VUE$SYSTEM_PROFILE. VUE$DAT 


Purpose 


Print help file 

Puzzle help file 

Session Manager help file 
Terminal Emulator help file 
FileView help file 

Ada build file 


FileView verb command files 


FileView default system 
profile 


Component 
Class 


ALL 
ALL 
ALL 
ALL 
ALL 
PROG 


ALL 
ALL 
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- Layered Products Information 


Because of the way the VMS Version 5.2 upgrade procedure is designed, 
you should not have to reinstall most layered products after the upgrade. 
However, you must reinstall certain layered products because of product- 
specific installation procedures. For example, you must reinstall products 
that create directories synonymous with system directories and products 
that use VMS-defined data structures. If a product is available (see 
Table E-1), yet exhibits unexpected behavior once Version 5.2 is running, 
check the current version of the VMS Release Notes for layered product 
cautions. If problems persist, contact your Digital support representative. 


Table E-1 lists the most recent versions of layered products that are 
currently supported for VMS Version 5.2. VAX PCL 2.0 will be supported 
sometime after VMS Version 5.2. 


Table E-1 Layered Products Currently Available for VMS Version 5.2 


Product Name Version Number 
AAF01/VMS Subroutine Library 2.0 
ADF01/VMS Subroutine Library 4.0 
ALL-IN-1 2.3 
ALL-IN-1 Starter 1.0 
ALL-IN-1 System for Sales and Marketing 1.2 
ALL-IN-1/BEV 2.1 
BASEVIEW 1.2 
C.A.S. Delivery System 1.6 
CMR21 Host Utility 1.1 
Courseware Authoring System 1.6 
Courseware Design System 1.6 
DECDX/VMS 1.1 
DECintact 1.0A 
DECnet Router Server 1.2 
DECnet/SNA Data Transfer Facility 2.0 
DECnet/SNA Gateway aes. 
DECnet/SNA Gateway for Channel Transport 1.0 
DECnet/SNA Gateway for Synchronous Transport 1.0 
DECnet/SNA VMS 3270 Data Stream Programming 1.4 
Interface 

DECnet/SNA VMS 3270 Terminal Emulator 1.4 
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Layered Products Information 


Table E—1 (Cont.) Layered Products Currently Available for VMS Version 5.2 


Product Name Version Number 





DECnet/SNA VMS APPC/LU6.2 Programming Interface 2.1 


DECnet/SNA VMS Application Programming !nterface 2.2 
DECnet/SNA VMS DISOSS Document Exchange Facility 1.4 
DECnet/SNA VMS Distributed Host Command Facility 1.2 
DECnet/SNA VMS Gateway Management 2.0 
DECnet/SNA VMS Printer Emulator 1.4 
DECnet/SNA VMS Remote Job Entry 1.3 
DECnet-VAX + 52 
DECpage 3.0 
DECrouter 200 1.1 
DECrouter 2000 1.1 
DECserver 100 2.0 
DECserver 200 for VAX/VMS and MicroVMS 2.0 
DECserver 500/VMS 1A 
DECtalk Mail Access 1.1 
DECvoice Software 1.0 
DEC GKS for VMS 4.0 
DEC GKS-3D for VMS 1.0 
DEC PHIGS for VMS 1.1 
DRB32 VMS Drivers 2.0A 
DRX11-C/VMS Driver 6.0 
VAX DY32 3.0 
Ethernet Terminal Server 3.0 
External Document Exchange with IBM DISOSS 2.1 
—=> Fortran IV/VAX to RSX 2.8 
IEX-VMS-Driver 4.0 
IXV/VAXELN Driver 2.0 
IXV11/VMS Driver 2.0 
KMV1A MicroVAX Driver 2.0 
KMV1A MicroVAX Driver and Development Tools 2.0 
KMV1A MicroVAX Driver and X.25 Link Level Software 2.0 
LAN Traffic Monitor 1.1 
LCGO1 Software 1.4 
MicroVAX VSV21 Support Software 3.0 
MicroVAX/DRQ3B Device Driver 1.2 
MicroVAX MIRA Switch Control 2.1 
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Table E—1 (Cont.) Layered Products Currently Available for VMS Version 5.2 


Product Name 


MicroVMS TSV05 Device Driver 
MUXserver 100 Remote Terminal Server 
NMCC/DECnet Monitor 

NMCC/VAX ETHERnim 

PBXserver 

PDP-11 DATATRIEVE/VAX 

PDP-11 FORTRAN-77/VAX to RSX 
PDP-11 Symbolic Debugger/VAX To RSX 
PLXY-11/VAX 

ReGIS Software 

Remote Bridge Management Software 
Remote System Manager 

Session Support Utility 

Spatial/I| 

Terminal Server Manager 

VAX 2780/3780 Protocol Emulator 
VAX 3271 Protocol Emulator 

VAX ACMS 

VAX Ada 

VAX APL 

VAX BASIC 

VAX BCP 

VAX BLISS-32 Implementation Language 
VAX C 

VAX COBOL 

VAX COBOL Generator 

VAX CDD/Plus 

VAX CoProcessor/RSX 

VAX DAL 

VAX Data Distributor 

VAX DATATRIEVE 

VAX DBMS 

VAX DEC/CMS 

VAX DEC/Map 

VAX DEC/MMS 

VAX DEC/Shell 


Layered Products Information 


Version Number 


4.2 


2.2 
2.1 
2.1 
2.0 
3.2 
5.3 
24 
1.4 
1.1 
1.2 
2.1 
1.1 
1.1 
1.2 
1.7 
2.4 
3.0A 
1.5 
3.41 
3.3 
1.1 
4.5 
3.0 
4.2A 
1.3 
4.0 
1.0 
1.6 
2.0-1 
4.2 
4.0 
3.1 
2.4 
2.4 
21 
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Table E~1 (Cont.) Layered Products Currently Available for VMS Version 5.2 


Product Name Version Number 
VAX DEC/Test Manager 2.3 
VAX DECalc 3.0 
VAX DECalc-Plus 3.0 
VAX DECaic/DECgraph Package 3.0 
VAX DECgraph eS 
VAX DECrad 3.2 
VAX DECreporter 2.1 
VAX DECscan VMS and ELN Bitbus Drivers 2.0 
VAX DECscan VMS Software Toolkit 2.0 
VAX DECslide 1.3 
VAX DECspell Verifier/Corrector 1.1 
VAX DECtype 4.0 
VAX Decision Expert for VMS 1.0 
VAX DIBOL 4.0 
VAX Distributed File Service 1.1 
VAX Distributed Name Service 1.1A 
VAX Distributed Queuing Service 1.1 
VAX DOCUMENT 1.1 
VAX DSM 5.0 
VAX DT07 3.0 
VAX EDCS 1.2 
VAX Encryption 1.1 
VAX FMS 2.4 
~~=> VAX FORTRAN 5.2 
VAX FTAM 1.1 
VAX Grammar Checker 1.0 
VAX High Performance Workstation Software 1.1 
VAX Jukebox Control Software 1.0 
VAX KCT32 2.0 
VAX Key Distribution Center 1.1 
VAX KMS11-BD/BE HDLC/BSC Framing Software 2.0 
VAX KMS11-BD/BE X.25 Link Level Software 2.0 
VAX Language Sensitive Editor 2.2 
VAX LIMS/SM 1.3 
VAX LISP for VMS Systems 2.2 
VAX Message Router 3.1 
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Table E—1 (Cont.) Layered Products Currently Available for VMS Version 5.2 


Product Name Version Number 
VAX Message Router X.400 Gateway 2.1 : 
VAX Message Router/P Gateway Pa 
VAX Message Router/S Gateway 1.1 
VAX Notes 2.0 
— VAX OPS5 3.0 
VAX OSI Application Kernel Tal 
VAX OSI Transport Service 2.0 
VAX Pascal 3.9 
VAX PBX/Facilities Management 3.0 
VAX Performance Advisor 1.2 
VAX Performance and Coverage Analyzer 2.0 
VAX PL/I 3.3 
VAX PrintServer Client Software 3.0 
VAX PrintServer Supporting Host Software 3.0 
VAX Producer Ver 
VAX Producer Interpreter 1.7 
VAX PSI 4.2 
VAX PSI Access 4.2 
VAX Public Access Communications 1.2 
VAX Rally 2.0 
VAX Rdb/ELN 2.1 
VAX Rdb/VMS 3.0A 
VAX Real-Time Accelerator Software 2.0 
VAX ReGIS to Sixels Converter 1.0 
VAX RMS Journaling 5.2 
VAX RPG Il 2.1 
VAX Scan 1.1 
VAX Scriptprinter Software 2.0 
VAX Software Project Manager 1.2 
VAX Source Code Analyzer 1.2 
VAX SPM 3.2 
VAX SQL | 2.0 
VAX TDMS 1.8 
VAX TEAMDATA | use: 
VAX TU70/72 Device Driver 1.2 
VAX VALU 2.1 


(continued on next page) 
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Layered Products Information 


Table E-1 (Cont.) Layered Products Currently Available for VMS Version 5.2 


Product Name 


VAX Volume Shadowing 
_ VAX VTX 
VAX Wide Area Network Device Drivers 
VAX XWAY 
VAXcluster Console System 
VAXcluster Software 
VAXELN Ada 
VAXELN Toolkit 
VAXimage Application Services for VMS 
VAXimage Scanning Application 
VAXinfo | 
VAXinfo Il 
VAXinfo Ill 
VAXlab Software Library 
VAXlink for IMS and VSAM Client 
VAXset 
VAX-11 RSX 
VAX-11 RTEM' 
VAX/PC LAN Server 
VAX/VMS Services for MS-DOS 
VIDA with IDMS/R 
VMS/SNA 
VMS/ULTRIX Connection (tm) 
VMS Workstation Software 
VS11-VAX Driver 


——> WPS-PLUS/VMS 


X25Router 2000 


'Refer to the cover letter for RTEM, Version 2.3. 
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Version Number 


5.2 
3.1 
1.1 
1.1A 
1.2 
5.2 
1.2 
3.2 
1.0 
1.0 
1.4 
1.4 
1.4 
1.3A 
1.0 
Release 7 
2.4 
2.3 
1.0-B 
2.1 
2.1 
1.3 
1.0 
4.0A 


2.5 


3.0 
1.0 


FE Release Notes for the VAX 8200 


If you are installing the VMS operating system on a VAX 8200 from an 
HSC disk drive, read this section before you perform the installation. 





F.1 How to Proceed 


If you have edited the CIBOO.CMD file on the console RX50 to reflect your 
system configuration, you can use the BOOT58 program and a modified 
version of CIBOO.CMD (DEFBOO.CMD) to boot the VMS operating 
system automatically from an HSC disk drive. Install the VMS operating 
system as described in VMS Installation and Operations: VAX 8200, 8250, 
8300, 8350. 


If you have not edited the CIBOO.CMD file to reflect your system 
configuration, the BOOT58 program displays syntax error messages 
when you try to boot the VMS operating system automatically. You must 
deposit values at the BOOT58> prompt to boot the VMS operating system 
manually from an HSC disk drive. If you have not edited CIBOO.CMD, 
install the VMS operating system as described in the following sections. 


Once you have installed and booted the VMS operating system and are 
logged in to the SYSTEM account, you can edit CIBOO.CMD. Then you 
can use a modified version of CIBOO.CMD (DEFBOO.CMD) to perform 
subsequent boots. 


F.2 Installing the VMS Operating System 


If you have not edited CIBOO.CMD, follow this procedure to install the 
VMS operating system from an HSC drive. 


Prepare for the installation as described in the VMS Installation and 
Operations: VAX 8200, 8250, 8300, 8350. Obtain the following information 
from either the network or VAXcluster manager: 


¢ VAXBI node number 
¢ HSC node number 
e HSC controller number or numbers 


e Unit number of the disk drive 


Then boot standalone BACKUP as follows: 


1 Identify the disk drive that contains the distribution disk and the HSC 
that controls it. You need to know the node number of the HSC and 
the unit number of the disk drive. 


2 Make sure the console RX50 is in the console diskette drive, CSA1. 
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3 To start the BOOT58 program, enter the following command and press 
RETURN: 


>>> B/R5:800 CSAI1 


4 At the BOOTS58> prompt, deposit the following values. Note that all 
numeric entries are made using hexadecimal notation. 


a. 


Note: 


Deposit the value 20 for the type code for the boot device for 
the HSC on a CIBCI or CIBCA device into register 0 using the 
following command: 


BOOT58> D/G 0 20 


Deposit the VAXBI node number into register 1 using the following 
format: | 


BOOT58> D/G 1 node-number 


For example, if the VAXBI is node 6, enter the following and press 
RETURN: 


BOOT58> D/G 1 6 


Deposit the HSC node number into register 2 using the following 
format: 


BOOTS58> D/G 2 node-number 


For example, if the HSC is node 12 on a CIBCI device, enter the 
following command and press RETURN: 


BOOT58>D/G 2 C 


If the drive holding the system disk is accessible to 

two HSCs, deposit both node numbers. Put the greater 
number in hexadecimal digits 3 and 2, and the lesser 

in digits 1 and 0. For example, suppose one HSC is 
numbered 18 (hexadecimal 12) and the other is numbered 
10 (hexadecimal A), enter the following and press RETURN: 


BOOT58>D/G 2 120A 


Deposit the unit number of the drive holding the system disk into 
register 3 using the following format: 


BOOT58>D/G 3 unit-number 


For example, if the drive holding the system disk is unit number 
21, deposit hexadecimal 15 into register 3: 


BOOT58>D/G 3 15 


Deposit the number of the correct root directory from which to boot 
using the foliowing format (where r is the directory root): 


BOOT58>D/G 5 r0000000 


By default, the VMS operating system is in SYSO. For example, 
if the correct root directory is SYSO, enter the following and press 
RETURN: 


BOOT58>D/G 5 0 
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f. Enter the following commands and press RETURN after each one: 
BOOT58> p/G 4 0 
BOOTSS> D/G FE 260 


BOOTS8> LOAD VMB.EXE/START:200 
BOOTSS> START. 2006 


The procedure may ask for the date and time. Enter the date and time 
using the 24-hour clock format and press RETURN. For example: 


VAX/VMS Version V5.2 Major version id = 01 Minor version id = 00 

PLEASE ENTER DATE AND TIME (DD-MMM-YYY HH:MM:) 19-apR-1990 13:00 

The procedure displays a list of the local devices on your system and, 
if you have them, HSC- and MSCP-served devices. For example: 


Available device DJA2 device type RA6O 
Available device DJA3 device type RA60 


Check the list of devices. If the list is incomplete, make sure that all 
the drives are connected properly to the system. See your hardware 
manuals for details. 


When standalone BACKUP finishes booting, it displays an 
identification message followed by the dollar sign prompt ($): 


*SBACKUP-I~IDENT, Stand-alone BACKUP V5.2; the date is 19-APR~1990 13:00:00.00) 
$ 


Continue installing the VMS operating system as described in the VMS 
Installation and Operations: VAX 8200, 8250, 8300, 8350. 


F.3 Editing CIBOO.CMD 


Once you have installed and booted the VMS operating system and are 
logged in to the SYSTEM account, edit the CIBOO.CMD file using the 
following procedure: 


Note: 


If you are editing CIBOO.CMD on a hardcopy terminal you must 
use line mode edit. You might want to use a video display terminal 
instead. 
1 Make sure the console RX50 is in the console diskette drive, CSA1. 
2 To connect the console drive to the system, enter the following 
commands and press RETURN after each one: 
S$ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> FXIT 
3 Use the Exchange Utility to copy CIBOO.CMD to the system disk. 
Enter the following command and press RETURN: 
$ EXCHANGE COPY CSA1:CIBOO.CMD *.* 
4 To edit CIBOO.CMD, enter the following command and press 


RETURN: 


S EDIT CIBOO.CMD 
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CIBOO.CMD contains the following text: 


!CIBOO.CMD :Boot command file to boot a VAX 8200/8300 from an HSC disk. 
t a 


t 


{Note "n", "p" (and "q"), "u"™, and "r" are single hexadecimal characters 
ot 


D/G 0 20 ! CI Port Device Type Code 

Ip/G in !n = CI adaptor’s VAXBI node number 

1D/G 2 p ! Use the HSC controller at CI node p 

!D/G 2 0p0gq ! Use either the HSC controller at CI nodes p and q 
!D/G 3.u ! u = Disk drive unit number 

D/G 4 0 ! Boot Block LBN (not used) 

1D/G 5 r0000000 ! yr = system root [SYSR...], Software boot flags 
D/G E 200 ! Address of Working Memory+*X200 

LOAD VMB.EXE/START:200 ! Load Primary Bootstrap 

START 200 ! Start Primary Bootstrap 


a. Delete the comment character (!) that appears before the D/G 1 
command and replace n with the VAXBI node number of the CI 
adapter. 


b. If your computer is only connected to one HSC controller, delete 
the comment character (!) that appears before the first D/G 
2 command. Replace p with the HSC controller number in 
hexadecimal notation. Delete the second D/G 2 command. 


If the drive holding the system disk is connected to two HSC 
controllers, do the following: 


¢ Delete the comment character (!) that appears before the 
second D/G 2 command 


¢ Replace p with the controller number of the first HSC in 
hexadecimal notation 


¢ Replace g with the controller number of the second HSC in 
hexadecimal notation 


e Delete the first D/G 2 command 


c. Delete the comment character (!) that appears before the 
D/G 3 command and replace u with the unit number of the HSC 
drive from which you will boot the VMS operating system. Use 
hexadecimal notation. 


d. Delete the comment character (!) that appears before the 
D/G 5 command and replace r with the number of the correct 
root directory from which to boot. By default, the VMS operating 
system is in SYSO. 


e. Exit from the editor. 
Rename the file. Enter the following command and press RETURN: 
$ RENAME CIBOO.CMD DEFBOO.CMD 


Use the Exchange Utility to copy DEFBOO.CMD to the console RX50. 
Enter the following command and press RETURN: 


S$ EXCHANGE COPY DEFBOO.CMD CSA1:DEFBOO.CMD 


When you are finished, enter the following command and press 
RETURN: 


$ DISMOUNT CSAL 
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9 To secure the console from unauthorized access, you must enter the 
following command and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA1 


If you change the system configuration, use the previous procedure to 
modify CIBOO.CMD. 
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Technical Support 


If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 


your electronic, telephone, or direct mail order. 


Electronic Orders 


To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using a 1200- or 2400-baud 
modem. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location Call 


Continental USA, 800-DIGITAL 
Alaska, or Hawaii 


Puerto Rico 809-754-7575 
Canada 800-267-6215 
International 

Internal! 


Contact 


Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


Local DIGITAL subsidiary 


Digital Equipment of Canada 

Attn: DECdirect Operations KAO2/2 
P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 


Local DIGITAL subsidiary or 
approved distributor 


SDC Order Processing - WMO/E15 
or 

Software Distribution Center 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


1For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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